Handle an appointment request
POST/v1/agent/appointments/:appointmentId
Performs one staff action for an appointment owned by the application. The application API key determines ownership; unknown and cross-application appointment IDs both return APPOINTMENT_NOT_FOUND. Reusing the same Idempotency-Key with the same body replays the stored response.
Request
Responses
- 200
- 400
- 401
- 404
Durable action result. Customer message delivery is independent.
IDEMPOTENCY_KEY_REQUIRED, INVALID_APPOINTMENT_ACTION_PAYLOAD, APPOINTMENT_VERSION_CONFLICT, APPOINTMENT_STATE_CONFLICT, APPOINTMENT_SLOT_UNAVAILABLE, or another stable appointment validation error.
Missing, invalid, expired, or deleted application API key.
APPOINTMENT_NOT_FOUND.