Managing Appointments

{
  "resourceType": "Bundle",
  "type": "searchset",
  "total": 1,
  "entry": [
    {
      "resource": {
        "resourceType": "Appointment",
        "id": "appt-001",
        "status": "booked",
        "start": "2026-09-15T14:30:00.000Z",
        "end": "2026-09-15T15:00:00.000Z",
        "serviceType": [{ "text": "Follow-up consultation" }],
        "participant": [
          { "actor": { "reference": "Patient/pat-1001" }, "status": "accepted" },
          { "actor": { "reference": "Practitioner/Dr. Patel" }, "status": "accepted" }
        ]
      }
    }
  ]
}

{
  "resourceType": "Parameters",
  "parameter": [
    {
      "name": "appointment",
      "resource": {
        "resourceType": "Appointment",
        "status": "proposed",
        "serviceType": [{ "text": "Follow-up consultation" }],
        "start": "2026-09-15T14:30:00.000Z",
        "participant": [
          { "actor": { "reference": "Patient/pat-1001" } },
          { "actor": { "reference": "Practitioner/Dr. Patel" } }
        ]
      }
    }
  ]
}

{ "start": "2026-09-16T15:00:00.000Z" }

{ "statusCode": 404, "message": "Appointment {id} not found", "error": "Not Found" }

curl -X POST 'https://your-emma-domain/api/Appointment/appt-001/$cancel' \
  -H "Authorization: Bearer <jwt>"