Termin bearbeiten – API Hub
Zurück zum API Hub
PUT

Termin bearbeiten

Aktualisiert einen bestehenden Termin. Hiermit können Termine verschoben (neues startTime/endTime) oder einem anderen Therapeuten (neue assignedUserId) zugewiesen werden.

HTTP-Header

Authorization Bearer <TOKEN> Erforderlich
Content-Type application/json Erforderlich
Version 2021-04-15 Erforderlich

Path Parameter

appointmentId string Die ID des zu bearbeitenden Termins. Erforderlich

Request Body (JSON)

Es müssen nur die Felder gesendet werden, die geändert werden sollen. Zum Verschieben reichen startTime und endTime.

{
  // Beispiel 1: Termin verschieben
  "startTime": "2025-11-15T14:00:00+01:00",
  "endTime": "2025-11-15T15:00:00+01:00",

  // Beispiel 2: Termin einem anderen Therapeuten zuweisen
  "assignedUserId": "neue-user-id-hier",

  // Beispiel 3: Notiz hinzufügen oder Status ändern
  "notes": "Patient hat angerufen und Termin verschoben.",
  "appointmentStatus": "confirmed"
}

Beispiel Request (cURL)

Dieses Beispiel verschiebt den Termin mit der ID w9dpzkNaNC1vJ4uEv50Q auf 14:00 Uhr.

curl -X PUT 'https://services.leadconnectorhq.com/calendars/events/appointments/w9dpzkNaNC1vJ4uEv50Q' \
-H 'Authorization: Bearer <TOKEN>' \
-H 'Version: 2021-04-15' \
-H 'Content-Type: application/json' \
-d '{
  "startTime": "2025-11-15T14:00:00+01:00",
  "endTime": "2025-11-15T15:00:00+01:00"
}'

Beispiel-Response (200 OK)

{
  "id": "w9dpzkNaNC1vJ4uEv50Q",
  "calendarId": "1nBVY6R2cyx4qw86FJVD",
  "locationId": "UFeZwU5X6PIJLwU2XO3k",
  "contactId": "cVT5KgjznvtIfaf0UaaR",
  "startTime": "2025-11-15T14:00:00+01:00",
  "endTime": "2025-11-15T15:00:00+01:00",
  "appointmentStatus": "confirmed",
  "assignedUserId": "8xEuy8llxrPwDGmX8Hz8",
  "traceId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}