Errors

{
  "error": "validation_failed",
  "message": "patientPhone must be E.164 format",
  "requestId": "uuid-...",
  "errors": [
    { "path": "patientPhone", "message": "Invalid format" }
  ]
}

invalid_api_key       — key não existe ou foi revogada
expired_api_key       — key expirou (rotação anual)
malformed_auth_header — header Authorization mal formado

insufficient_scope    — key não tem o scope necessário
tenant_inactive       — clínica em status suspended
no_org_context        — JWT sem org_id (não acontece com API keys)

appointment_not_found
professional_not_found
service_not_found
tenant_not_provisioned — onboarding incompleto

slot_conflict         — outro paciente já marcou esse slot
status_transition     — não pode passar de cancelled → attended
duplicate_idempotency — Idempotency-Key já usado com payload diferente

{
  "error": "validation_failed",
  "message": "Invalid request body",
  "requestId": "...",
  "errors": [
    { "path": "professionalId", "message": "Expected uuid" },
    { "path": "startsAt",       "message": "Expected ISO 8601 datetime" }
  ]
}