curl --request POST \
  --url https://api.sortx.co.uk/planned-maintenance/programmes/{id}/end \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "requestId": "<string>",
  "expectedRevision": 123,
  "reason": "<string>"
}
'

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({requestId: '<string>', expectedRevision: 123, reason: '<string>'})
};

fetch('https://api.sortx.co.uk/planned-maintenance/programmes/{id}/end', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.sortx.co.uk/planned-maintenance/programmes/{id}/end"

payload = {
    "requestId": "<string>",
    "expectedRevision": 123,
    "reason": "<string>"
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "id": "<string>",
  "reference": "<string>",
  "name": "<string>",
  "status": "active",
  "templateId": "<string>",
  "templateName": "<string>",
  "serviceCategory": "<string>",
  "assetClass": "<string>",
  "eventType": "<string>",
  "statutory": true,
  "instructions": "<string>",
  "propertyId": "<string>",
  "propertyLabel": "<string>",
  "blockId": "<string>",
  "blockLabel": "<string>",
  "assetId": "<string>",
  "assetLabel": "<string>",
  "complianceKind": "gas_safety",
  "recurrenceInterval": 123,
  "recurrenceUnit": "day",
  "anchorDay": 123,
  "instructionLeadDays": 123,
  "nextDueOn": "<string>",
  "overdue": true,
  "jobCategory": "<string>",
  "contractorContactId": "<string>",
  "contractorName": "<string>",
  "autoInstruct": true,
  "autoInstructSetAt": "<string>",
  "responsibleTeamId": "<string>",
  "responsibleTeamName": "<string>",
  "managerStaffId": "<string>",
  "managerName": "<string>",
  "costCodeId": "<string>",
  "costCodeLabel": "<string>",
  "notes": "<string>",
  "liveEventId": "<string>",
  "liveEventStatus": "due",
  "liveEventReviewState": "pending",
  "endedAt": "<string>",
  "endReason": "<string>",
  "revision": 123,
  "createdByUserId": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "events": [
    {
      "id": "<string>",
      "programmeId": "<string>",
      "programmeReference": "<string>",
      "programmeName": "<string>",
      "occurrence": 123,
      "reference": "<string>",
      "status": "due",
      "reviewState": "pending",
      "dueOn": "<string>",
      "instructBy": "<string>",
      "overdue": true,
      "revisit": true,
      "statutory": true,
      "propertyId": "<string>",
      "propertyLabel": "<string>",
      "blockId": "<string>",
      "blockLabel": "<string>",
      "assetId": "<string>",
      "assetLabel": "<string>",
      "complianceKind": "gas_safety",
      "contractorContactId": "<string>",
      "contractorName": "<string>",
      "instructedAt": "<string>",
      "instructionNotes": "<string>",
      "instructedAutomatically": true,
      "autoInstructSkippedReason": "<string>",
      "booking": {
        "appointmentId": "<string>",
        "status": "held",
        "startsAt": "<string>",
        "endsAt": "<string>",
        "staffId": "<string>",
        "staffName": "<string>",
        "revision": 123
      },
      "completedOn": "<string>",
      "completedAt": "<string>",
      "completedByUserId": "<string>",
      "completionNotes": "<string>",
      "reviewedAt": "<string>",
      "reviewedByUserId": "<string>",
      "reviewNotes": "<string>",
      "rejectionReason": "<string>",
      "remedialRepair": {
        "id": "<string>",
        "reference": "<string>"
      },
      "nextEventId": "<string>",
      "certificateDocumentId": "<string>",
      "costCodeId": "<string>",
      "cancelledAt": "<string>",
      "cancelReason": "<string>",
      "evidenceCount": 123,
      "revision": 123,
      "createdAt": "<string>",
      "updatedAt": "<string>"
    }
  ]
}

{
  "_tag": "TenantCreateRejected",
  "reason": "<string>",
  "field": "<string>"
}

{
  "_tag": "Unauthenticated"
}

{
  "_tag": "TenantSuspended",
  "tenantId": "<string>",
  "reason": "<string>"
}

{
  "_tag": "EntitlementMissing",
  "tenantId": "<string>",
  "moduleId": "<string>"
}

{
  "_tag": "TenantNotFound",
  "slug": "<string>"
}

{
  "_tag": "WebhookDuplicate",
  "integration": "<string>",
  "externalId": "<string>"
}

{
  "_tag": "RateLimited",
  "key": "<string>",
  "retryAfterSeconds": 123,
  "message": "<string>"
}

{
  "_tag": "IntegrationUnavailable",
  "integration": "<string>",
  "detail": "<string>"
}