{"openapi":"3.1.0","info":{"title":"anam-calendar","version":"1.0.0-alpha.3","description":"Multi-tenant calendar and scheduling service. Neutral domain: subjects supply time, event types define policy, bookings hold occurrences, attendees are opaque references."},"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"ak_live_<key_id>.<secret>"}},"schemas":{}},"paths":{"/v1/system/timezone-alignment":{"get":{"operationId":"getV1SystemTimezoneAlignment","summary":"Compare runtime and database timezone data","tags":["operations"],"description":"Compare runtime and database timezone data","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/system/timezone-alignment \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/system/timezone-alignment', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/system/timezone-alignment\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/system/timezone-alignment', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/webhook-deliveries/{id}/replay":{"post":{"operationId":"postV1WebhookDeliveriesByIdReplay","summary":"Replay one dead letter","tags":["webhooks"],"description":"The replay reuses the original event id, which is exactly what makes the operation safe: the consumer's dedupe absorbs it.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"delivery_id":{"type":"string","format":"uuid"}},"required":["delivery_id"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/webhook-deliveries/00000000-0000-4000-8000-000000000000/replay \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/webhook-deliveries/00000000-0000-4000-8000-000000000000/replay', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/webhook-deliveries/00000000-0000-4000-8000-000000000000/replay\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/webhook-deliveries/00000000-0000-4000-8000-000000000000/replay', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/webhook-replays":{"post":{"operationId":"postV1WebhookReplays","summary":"Replay a range of deliveries","tags":["webhooks"],"description":"Replay a range of deliveries","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"from":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"to":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"types":{"type":["array","null"],"items":{"type":"string","maxLength":100},"maxItems":50}},"required":["from","to"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"enqueued":{"type":"integer"}},"required":["enqueued"],"additionalProperties":false}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/webhook-replays \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/webhook-replays', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/webhook-replays\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/webhook-replays', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/webhook-deliveries":{"get":{"operationId":"getV1WebhookDeliveries","summary":"Inspect the delivery queue and the dead letter queue","tags":["webhooks"],"description":"One professional's queue when the request names a tenant; the queue of every professional the organization manages when it does not, each row carrying `tenant_id`.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","enum":["pending","delivering","succeeded","failed","dead"]},"in":"query","name":"state","required":false},{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"in":"query","name":"limit","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":{}}}},"required":["data"],"additionalProperties":false}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/webhook-deliveries \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/webhook-deliveries', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/webhook-deliveries\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/webhook-deliveries', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/bookings/checksums":{"get":{"operationId":"getV1BookingsChecksums","summary":"Reconciliation checksums per host","tags":["operations"],"description":"Reconciliation checksums per host","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"from","required":true,"description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"to","required":true,"description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":{}}}},"required":["data"],"additionalProperties":false}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/bookings/checksums \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/bookings/checksums', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/bookings/checksums\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/bookings/checksums', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/messenger-webhooks":{"post":{"operationId":"postV1MessengerWebhooks","summary":"Receive a delivery receipt from anam-messenger","tags":["operations"],"description":"Receive a delivery receipt from anam-messenger","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,255}$"},"type":{"type":"string","pattern":"^[a-z][a-z0-9_.-]{0,127}$"},"occurred_at":{"type":"string","format":"date-time"},"data":{"type":"object","properties":{"channel":{"type":"string","enum":["push","email","whatsapp","sms"]},"reason":{"type":"string","pattern":"^[a-zA-Z0-9_.-]{1,80}$"},"source":{"type":"object","properties":{"system":{"type":"string","enum":["anam-calendar"]},"event_id":{"type":"string","format":"uuid"},"event_version":{"type":"integer","minimum":0,"maximum":2147483647}},"additionalProperties":false},"error":{"type":"object","properties":{"code":{"type":"string","pattern":"^[a-zA-Z0-9_.-]{1,80}$"}},"required":["code"],"additionalProperties":false}},"additionalProperties":false}},"required":["id","type","occurred_at","data"],"additionalProperties":false}}}},"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"accepted":{"type":"boolean"}},"required":["accepted"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/messenger-webhooks \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/messenger-webhooks', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/messenger-webhooks\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/messenger-webhooks', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/audit-events":{"get":{"operationId":"getV1AuditEvents","summary":"Read persisted tenant audit receipts and optionally reveal scheduling justifications","tags":["audit"],"description":"Read persisted tenant audit receipts and optionally reveal scheduling justifications","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","maxLength":100},"in":"query","name":"action","required":false},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"include_scheduling_justifications","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"action":{"type":"string"},"actor_kind":{"type":"string"},"target_type":{"type":"string"},"target_id":{"type":["string","null"],"format":"uuid"},"outcome":{"type":"string","enum":["allowed","refused"]},"occurred_at":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"request_id":{"type":["string","null"]},"scheduling_justification":{"type":"string"}},"required":["id","action","actor_kind","target_type","target_id","outcome","occurred_at","request_id"],"additionalProperties":false}},"page":{"type":"object","properties":{"next_cursor":{"type":["string","null"]},"has_more":{"type":"boolean"},"limit":{"type":"number"}},"required":["next_cursor","has_more","limit"],"additionalProperties":false}},"required":["data","page"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/audit-events \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/audit-events', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/audit-events\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/audit-events', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/organization/audit":{"get":{"operationId":"getV1OrganizationAudit","summary":"List append-only organization audit metadata","tags":["operations"],"description":"List append-only organization audit metadata","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string","maxLength":512},"in":"query","name":"cursor","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"action":{"type":"string","enum":["branding.changed","branding.asset_changed","organization.settings_changed"]},"actor":{"type":"string"},"actor_kind":{"type":"string","enum":["api_credential","operator","system"]},"target_type":{"type":"string"},"target_id":{"type":["string","null"],"format":"uuid"},"request_id":{"type":["string","null"]},"data":{"type":"object","additionalProperties":{}},"created_at":{"type":"string"}},"required":["id","action","actor","actor_kind","target_type","target_id","request_id","data","created_at"],"additionalProperties":false},"maxItems":100},"page":{"type":"object","properties":{"next_cursor":{"type":["string","null"]},"has_more":{"type":"boolean"},"limit":{"type":"integer"}},"required":["next_cursor","has_more","limit"],"additionalProperties":false}},"required":["data","page"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/organization/audit \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/organization/audit', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/organization/audit\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/organization/audit', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/hosts":{"post":{"operationId":"postV1Hosts","summary":"Create a host","tags":["configuration"],"description":"Create a host","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"external_ref":{"type":["string","null"],"maxLength":255},"display_label":{"type":"string","minLength":1,"maxLength":200},"public_profile":{"type":"object","properties":{"show_logo":{"type":"boolean"},"professional_name":{"type":["string","null"],"minLength":1,"maxLength":200,"pattern":"^[^<>\\p{Cc}]+$"},"email_message":{"type":["string","null"],"maxLength":1000,"pattern":"^[^<>\\u0000-\\u0008\\u000B\\u000C\\u000E-\\u001F\\u007F\\u202A-\\u202E\\u2066-\\u2069]*$"},"calendar_name":{"type":["string","null"],"minLength":1,"maxLength":200,"pattern":"^[^<>\\p{Cc}]+$"},"registration":{"type":["string","null"],"minLength":1,"maxLength":80,"pattern":"^[^<>\\p{Cc}]+$"},"profession":{"type":["string","null"],"minLength":1,"maxLength":120,"pattern":"^[^<>\\p{Cc}]+$"},"photo_url":{"type":["string","null"],"maxLength":2048,"format":"uri"},"email":{"type":["string","null"],"maxLength":254,"format":"email"},"phone":{"type":["string","null"],"pattern":"^\\+[1-9]\\d{6,14}$"}},"additionalProperties":false},"timezone":{"type":"string","description":"IANA timezone identifier"},"kind":{"type":"string","enum":["host","resource"],"default":"host"},"max_per_day":{"type":["integer","null"],"minimum":1},"max_per_week":{"type":["integer","null"],"minimum":1}},"required":["display_label","timezone"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"external_ref":{"type":["string","null"]},"display_label":{"type":"string"},"public_profile":{"type":"object","properties":{"show_logo":{"type":"boolean"},"professional_name":{"type":["string","null"],"minLength":1,"maxLength":200,"pattern":"^[^<>\\p{Cc}]+$"},"email_message":{"type":["string","null"],"maxLength":1000,"pattern":"^[^<>\\u0000-\\u0008\\u000B\\u000C\\u000E-\\u001F\\u007F\\u202A-\\u202E\\u2066-\\u2069]*$"},"calendar_name":{"type":["string","null"],"minLength":1,"maxLength":200,"pattern":"^[^<>\\p{Cc}]+$"},"registration":{"type":["string","null"],"minLength":1,"maxLength":80,"pattern":"^[^<>\\p{Cc}]+$"},"profession":{"type":["string","null"],"minLength":1,"maxLength":120,"pattern":"^[^<>\\p{Cc}]+$"},"photo_url":{"type":["string","null"],"maxLength":2048,"format":"uri"},"email":{"type":["string","null"],"maxLength":254,"format":"email"},"phone":{"type":["string","null"],"pattern":"^\\+[1-9]\\d{6,14}$"}},"additionalProperties":false},"timezone":{"type":"string"},"status":{"type":"string"},"kind":{"type":"string"},"availability_epoch":{"type":"integer"},"max_per_day":{"type":["integer","null"]},"max_per_week":{"type":["integer","null"]}},"required":["id","external_ref","display_label","timezone","status","kind","availability_epoch","max_per_day","max_per_week"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"502":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/hosts \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/hosts', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/hosts\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/hosts', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]},"get":{"operationId":"getV1Hosts","summary":"List hosts","tags":["configuration"],"description":"One professional's hosts when the request names a tenant; every host of every professional the organization manages when it does not, each carrying `tenant_id`.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"external_ref":{"type":["string","null"]},"display_label":{"type":"string"},"public_profile":{"type":"object","properties":{"show_logo":{"type":"boolean"},"professional_name":{"type":["string","null"],"minLength":1,"maxLength":200,"pattern":"^[^<>\\p{Cc}]+$"},"email_message":{"type":["string","null"],"maxLength":1000,"pattern":"^[^<>\\u0000-\\u0008\\u000B\\u000C\\u000E-\\u001F\\u007F\\u202A-\\u202E\\u2066-\\u2069]*$"},"calendar_name":{"type":["string","null"],"minLength":1,"maxLength":200,"pattern":"^[^<>\\p{Cc}]+$"},"registration":{"type":["string","null"],"minLength":1,"maxLength":80,"pattern":"^[^<>\\p{Cc}]+$"},"profession":{"type":["string","null"],"minLength":1,"maxLength":120,"pattern":"^[^<>\\p{Cc}]+$"},"photo_url":{"type":["string","null"],"maxLength":2048,"format":"uri"},"email":{"type":["string","null"],"maxLength":254,"format":"email"},"phone":{"type":["string","null"],"pattern":"^\\+[1-9]\\d{6,14}$"}},"additionalProperties":false},"timezone":{"type":"string"},"status":{"type":"string"},"kind":{"type":"string"},"availability_epoch":{"type":"integer"},"max_per_day":{"type":["integer","null"]},"max_per_week":{"type":["integer","null"]},"tenant_id":{"type":"string","format":"uuid"}},"required":["id","external_ref","display_label","timezone","status","kind","availability_epoch","max_per_day","max_per_week"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"502":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/hosts \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/hosts', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/hosts\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/hosts', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/hosts/{hostId}/event-types":{"post":{"operationId":"postV1HostsByHostidEventTypes","summary":"Create an event type","tags":["configuration"],"description":"Create an event type","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{1,62}$"},"name":{"type":"string","minLength":1,"maxLength":200},"description":{"type":["string","null"],"maxLength":2000},"duration_minutes":{"type":"integer","minimum":1,"maximum":1440},"buffer_before_minutes":{"type":"integer","minimum":0,"maximum":1440,"default":0},"buffer_after_minutes":{"type":"integer","minimum":0,"maximum":1440,"default":0},"min_notice_minutes":{"type":"integer","minimum":0,"maximum":2147483647,"default":0},"cancel_notice_minutes":{"type":"integer","minimum":0,"maximum":525600,"default":0,"description":"Minutes before the start during which the attendee may not cancel. The host is not bound. Zero means until the start."},"reschedule_notice_minutes":{"type":"integer","minimum":0,"maximum":525600,"default":0,"description":"Minutes before the start during which the attendee may not move the occurrence. Measured against the occurrence being moved. The host is not bound."},"max_horizon_days":{"type":"integer","minimum":1,"maximum":730,"default":60},"slot_interval_minutes":{"type":"integer","minimum":1,"maximum":1440,"default":15},"capacity":{"type":"integer","minimum":1,"maximum":500,"default":1},"session_shape":{"type":"string","enum":["individual","joint","group"],"description":"individual is one attendee. joint is a couple or family: one withdrawal cancels the session. group is one seat per booking, and capacity is how many seats share the start. Omitted: capacity above 1 is a group, otherwise individual."},"confirmation_policy":{"type":"string","enum":["auto","approval"],"default":"auto"},"visibility":{"type":"string","enum":["public","internal"],"default":"public"},"hold_ttl_seconds":{"type":"integer","minimum":30,"maximum":86400,"default":600},"approval_ttl_seconds":{"type":"integer","minimum":60,"maximum":2592000,"default":172800},"reminder_offsets":{"type":["array","null"],"items":{"type":"string"}},"location_kind":{"type":"string","maxLength":50,"default":"virtual"},"video_mode":{"type":"string","enum":["none","static","per_occurrence"],"default":"none"},"static_join_url":{"type":["string","null"],"maxLength":800}},"required":["slug","name","duration_minutes"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"hostId","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"duration_minutes":{"type":"integer"},"buffer_before_minutes":{"type":"integer"},"buffer_after_minutes":{"type":"integer"},"min_notice_minutes":{"type":"integer"},"cancel_notice_minutes":{"type":"integer"},"reschedule_notice_minutes":{"type":"integer"},"max_horizon_days":{"type":"integer"},"slot_interval_minutes":{"type":"integer"},"capacity":{"type":"integer"},"session_shape":{"type":"string","enum":["individual","joint","group"]},"confirmation_policy":{"type":"string"},"visibility":{"type":"string"},"hold_ttl_seconds":{"type":"integer"},"approval_ttl_seconds":{"type":"integer"},"reminder_offsets":{"type":["array","null"],"items":{"type":"string"}},"location_kind":{"type":"string"},"video_mode":{"type":"string","enum":["none","static","per_occurrence"]},"static_join_url":{"type":["string","null"]},"active":{"type":"boolean"}},"required":["id","host_id","slug","name","description","duration_minutes","buffer_before_minutes","buffer_after_minutes","min_notice_minutes","cancel_notice_minutes","reschedule_notice_minutes","max_horizon_days","slot_interval_minutes","capacity","session_shape","confirmation_policy","visibility","hold_ttl_seconds","approval_ttl_seconds","reminder_offsets","location_kind","video_mode","static_join_url","active"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"502":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/event-types \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/event-types', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/hosts/00000000-0000-4000-8000-000000000000/event-types\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/event-types', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/event-types":{"get":{"operationId":"getV1EventTypes","summary":"List event types","tags":["configuration"],"description":"One professional's event types when the request names a tenant; every professional's when it does not, each carrying `tenant_id`.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"host_id","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"duration_minutes":{"type":"integer"},"buffer_before_minutes":{"type":"integer"},"buffer_after_minutes":{"type":"integer"},"min_notice_minutes":{"type":"integer"},"cancel_notice_minutes":{"type":"integer"},"reschedule_notice_minutes":{"type":"integer"},"max_horizon_days":{"type":"integer"},"slot_interval_minutes":{"type":"integer"},"capacity":{"type":"integer"},"session_shape":{"type":"string","enum":["individual","joint","group"]},"confirmation_policy":{"type":"string"},"visibility":{"type":"string"},"hold_ttl_seconds":{"type":"integer"},"approval_ttl_seconds":{"type":"integer"},"reminder_offsets":{"type":["array","null"],"items":{"type":"string"}},"location_kind":{"type":"string"},"video_mode":{"type":"string","enum":["none","static","per_occurrence"]},"static_join_url":{"type":["string","null"]},"active":{"type":"boolean"},"tenant_id":{"type":"string","format":"uuid"}},"required":["id","host_id","slug","name","description","duration_minutes","buffer_before_minutes","buffer_after_minutes","min_notice_minutes","cancel_notice_minutes","reschedule_notice_minutes","max_horizon_days","slot_interval_minutes","capacity","session_shape","confirmation_policy","visibility","hold_ttl_seconds","approval_ttl_seconds","reminder_offsets","location_kind","video_mode","static_join_url","active"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"502":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/event-types \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/event-types', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/event-types\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/event-types', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/hosts/{hostId}/availability-rules":{"put":{"operationId":"putV1HostsByHostidAvailabilityRules","summary":"Replace a host's availability rules","tags":["configuration"],"description":"Recurring windows are anchored to a wall clock in an IANA zone, so 09:00 stays 09:00 across a DST change. A blackout is also materialised into the occupancy ledger, which is what makes the database refuse a booking during a holiday rather than relying on the engine remembering to subtract it. Provisioning shape: the whole rule set is replaced, so two callers editing at once lose each other's work. A professional changing one afternoon should use PUT /v1/me/schedule and the exception routes instead, which touch only what they name.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"rules":{"type":"array","items":{"anyOf":[{"type":"object","properties":{"rule_kind":{"type":"string","enum":["recurring"]},"event_type_id":{"type":["string","null"],"format":"uuid"},"rrule":{"type":"string","minLength":3},"start_time_local":{"type":"string","pattern":"^\\d{2}:\\d{2}(:\\d{2})?$"},"window_minutes":{"type":"integer","minimum":1,"maximum":1440},"timezone":{"type":"string","description":"IANA timezone identifier"},"effective_from":{"type":"string","format":"date"},"effective_until":{"type":["string","null"],"format":"date"}},"required":["rule_kind","rrule","start_time_local","window_minutes"],"additionalProperties":false},{"type":"object","properties":{"rule_kind":{"type":"string","enum":["override"]},"event_type_id":{"type":["string","null"],"format":"uuid"},"override_date":{"type":"string","format":"date"},"start_time_local":{"type":"string","pattern":"^\\d{2}:\\d{2}(:\\d{2})?$"},"window_minutes":{"type":"integer","minimum":1,"maximum":1440},"timezone":{"type":"string","description":"IANA timezone identifier"}},"required":["rule_kind","override_date","start_time_local","window_minutes"],"additionalProperties":false},{"type":"object","properties":{"rule_kind":{"type":"string","enum":["blackout"]},"event_type_id":{"type":["string","null"],"format":"uuid"},"starts_at":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"ends_at":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"reason":{"type":["string","null"],"maxLength":280}},"required":["rule_kind","starts_at","ends_at"],"additionalProperties":false}]},"maxItems":200}},"required":["rules"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"hostId","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"replaced":{"type":"integer"}},"required":["replaced"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"502":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/availability-rules \\\n  --request PUT \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/availability-rules', {\n  method: 'PUT',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"PUT\",\n    \"/v1/hosts/00000000-0000-4000-8000-000000000000/availability-rules\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('PUT', 'https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/availability-rules', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]},"get":{"operationId":"getV1HostsByHostidAvailabilityRules","summary":"List availability rules","tags":["configuration"],"description":"List availability rules","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"hostId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":{}}}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"502":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/availability-rules \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/availability-rules', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/hosts/00000000-0000-4000-8000-000000000000/availability-rules\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/availability-rules', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/webhook-endpoints":{"post":{"operationId":"postV1WebhookEndpoints","summary":"Register a webhook endpoint","tags":["webhooks"],"description":"The signing secret is returned once and never again. `event_types` is the index of what this service will send: an exact type, a family ending in `.*`, or `*`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"event_types":{"type":"array","items":{"type":"string"},"default":["*"],"description":"Exact types: booking.created, booking.updated, booking.pending_approval, booking.confirmed, booking.participant_responded, booking.declined, booking.rescheduled, booking.substituted, booking.cancelled, booking.removed, booking.completed, booking.no_show_marked, booking.conflict_detected, booking.queue_available, occurrence.rescheduled, occurrence.local_time_shifted, series.occurrence_skipped, series.extended, hold.expired, waitlist.offered, connection.sync_failed, connection.reauth_required, connection.drift_repaired, connection.connected, connection.revoked. A pattern ending in .* matches that family. * matches every type."},"description":{"type":["string","null"],"maxLength":280}},"required":["url"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"url":{"type":"string"},"secret":{"type":"string"},"event_types":{"type":"array","items":{"type":"string"}}},"required":["id","url","secret","event_types"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"502":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/webhook-endpoints \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/webhook-endpoints', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/webhook-endpoints\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/webhook-endpoints', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]},"get":{"operationId":"getV1WebhookEndpoints","summary":"List webhook endpoints","tags":["webhooks"],"description":"Endpoints belong to one professional, so this listing always names a tenant even for an organization credential.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","additionalProperties":{}}}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"502":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/webhook-endpoints \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/webhook-endpoints', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/webhook-endpoints\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/webhook-endpoints', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/tenants/{id}/lifecycle":{"get":{"operationId":"getV1TenantsByIdLifecycle","summary":"Read one organization-owned tenant lifecycle","tags":["tenants"],"description":"Read one organization-owned tenant lifecycle","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["active","suspended","archived"]},"revision":{"type":"integer","exclusiveMinimum":true,"minimum":0},"external_cleanup":{"type":"string","enum":["not_requested"]},"requires_reconsent":{"type":"boolean"}},"required":["id","status","revision","external_cleanup","requires_reconsent"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/tenants/00000000-0000-4000-8000-000000000000/lifecycle \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/tenants/00000000-0000-4000-8000-000000000000/lifecycle', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/tenants/00000000-0000-4000-8000-000000000000/lifecycle\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/tenants/00000000-0000-4000-8000-000000000000/lifecycle', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]},"post":{"operationId":"postV1TenantsByIdLifecycle","summary":"Suspend, archive or explicitly resume one tenant with CAS and durable fences","tags":["tenants"],"description":"Organization configuration authority only. Archive is terminal. Suspension/archive revoke issued grants, stop pending delivery/provider work and fence late callbacks/publication in the same transaction as audit and receipt. No external provider deletion, revocation, invitation or message is performed. Resume requires fresh grants and consent; it never restores cancelled work.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["active","suspended","archived"]},"expected_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["status","expected_revision"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["active","suspended","archived"]},"revision":{"type":"integer","exclusiveMinimum":true,"minimum":0},"external_cleanup":{"type":"string","enum":["not_requested"]},"requires_reconsent":{"type":"boolean"}},"required":["id","status","revision","external_cleanup","requires_reconsent"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/tenants/00000000-0000-4000-8000-000000000000/lifecycle \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/tenants/00000000-0000-4000-8000-000000000000/lifecycle', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/tenants/00000000-0000-4000-8000-000000000000/lifecycle\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/tenants/00000000-0000-4000-8000-000000000000/lifecycle', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/tenants":{"post":{"operationId":"postV1Tenants","summary":"Provision a tenant idempotently by organization and external reference","tags":["tenants"],"description":"A tenant is a customer isolation boundary. An integration may map it to an Account with several hosts. Reusing external_ref with incompatible name/timezone is a conflict; the id and original normalized configuration survive a lost reply.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"external_ref":{"type":"string","minLength":1,"maxLength":255},"name":{"type":"string","minLength":1,"maxLength":200},"timezone":{"type":"string","description":"IANA timezone identifier"}},"required":["external_ref","name"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organization_id":{"type":"string","format":"uuid"},"external_ref":{"type":["string","null"]},"slug":{"type":"string"},"name":{"type":"string"},"timezone":{"type":"string"},"status":{"type":"string"},"data_region":{"type":["string","null"]},"created_at":{"type":"string"}},"required":["id","organization_id","external_ref","slug","name","timezone","status","data_region","created_at"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/tenants \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/tenants', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/tenants\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/tenants', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]},"get":{"operationId":"getV1Tenants","summary":"List tenant metadata owned by this organization","tags":["tenants"],"description":"List tenant metadata owned by this organization","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"organization_id":{"type":"string","format":"uuid"},"external_ref":{"type":["string","null"]},"slug":{"type":"string"},"name":{"type":"string"},"timezone":{"type":"string"},"status":{"type":"string"},"data_region":{"type":["string","null"]},"created_at":{"type":"string"}},"required":["id","organization_id","external_ref","slug","name","timezone","status","data_region","created_at"],"additionalProperties":false}},"page":{"type":"object","properties":{"next_cursor":{"type":["string","null"]},"has_more":{"type":"boolean"},"limit":{"type":"number"}},"required":["next_cursor","has_more","limit"],"additionalProperties":false}},"required":["data","page"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/tenants \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/tenants', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/tenants\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/tenants', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/tenant/defaults":{"get":{"operationId":"getV1TenantDefaults","summary":"Read the tenant provisioning template","tags":["tenants"],"description":"Revision zero is the initial template. Resources that opted into inheritance follow global changes; explicit overrides and booked occurrences are preserved. A tenant selector and config:read authority without host/event-type narrowing are required.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"revision":{"type":"integer","minimum":0},"defaults":{"type":"object","properties":{"notifications":{"type":"object","properties":{"session_reminders":{"type":"array","items":{"type":"object","properties":{"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_pack_id":{"type":"string"}},"required":["lead_minutes","template_pack_id"],"additionalProperties":false},"maxItems":3},"event_reminders":{"type":"array","items":{"type":"object","properties":{"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_pack_id":{"type":"string"}},"required":["lead_minutes","template_pack_id"],"additionalProperties":false},"maxItems":3}},"required":["session_reminders","event_reminders"],"additionalProperties":false},"timezone":{"type":"string"},"weekly":{"type":"array","items":{"type":"object","properties":{"weekday":{"type":"integer","minimum":0,"maximum":6,"description":"Monday = 0, Sunday = 6"},"blocks":{"type":"array","items":{"type":"object","properties":{"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^(([01]\\d|2[0-3]):[0-5]\\d|24:00)$"}},"required":["start","end"],"additionalProperties":false},"maxItems":12}},"required":["weekday","blocks"],"additionalProperties":false},"maxItems":7},"event_type":{"type":"object","properties":{"duration_minutes":{"type":"integer","minimum":1,"maximum":1440},"buffer_before_minutes":{"type":"integer","minimum":0,"maximum":1440},"buffer_after_minutes":{"type":"integer","minimum":0,"maximum":1440},"slot_interval_minutes":{"type":"integer","minimum":1,"maximum":1440},"min_notice_minutes":{"type":"integer","minimum":0,"maximum":2147483647},"max_horizon_days":{"type":"integer","minimum":1,"maximum":730},"confirmation_policy":{"type":"string","enum":["auto","approval"]}},"required":["duration_minutes","buffer_before_minutes","buffer_after_minutes","slot_interval_minutes","min_notice_minutes","max_horizon_days","confirmation_policy"],"additionalProperties":false}},"required":["timezone","weekly","event_type"],"additionalProperties":false}},"required":["revision","defaults"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/tenant/defaults \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/tenant/defaults', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/tenant/defaults\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/tenant/defaults', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]},"put":{"operationId":"putV1TenantDefaults","summary":"Replace tenant defaults with a durable receipt and revision check","tags":["tenants"],"description":"Full bounded template replacement. expected_revision is compared under a tenant row lock. Retry the same Idempotency-Key and normalized body after a lost response; incompatible reuse is rejected. Inherited configuration is applied atomically to participating resources. A schedule conflict rolls back the whole change; existing occurrences never move or cancel.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expected_revision":{"type":"integer","minimum":0},"defaults":{"type":"object","properties":{"notifications":{"type":"object","properties":{"session_reminders":{"type":"array","items":{"type":"object","properties":{"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_pack_id":{"type":"string"}},"required":["lead_minutes","template_pack_id"],"additionalProperties":false},"maxItems":3},"event_reminders":{"type":"array","items":{"type":"object","properties":{"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_pack_id":{"type":"string"}},"required":["lead_minutes","template_pack_id"],"additionalProperties":false},"maxItems":3}},"required":["session_reminders","event_reminders"],"additionalProperties":false},"timezone":{"type":"string"},"weekly":{"type":"array","items":{"type":"object","properties":{"weekday":{"type":"integer","minimum":0,"maximum":6,"description":"Monday = 0, Sunday = 6"},"blocks":{"type":"array","items":{"type":"object","properties":{"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^(([01]\\d|2[0-3]):[0-5]\\d|24:00)$"}},"required":["start","end"],"additionalProperties":false},"maxItems":12}},"required":["weekday","blocks"],"additionalProperties":false},"maxItems":7},"event_type":{"type":"object","properties":{"duration_minutes":{"type":"integer","minimum":1,"maximum":1440},"buffer_before_minutes":{"type":"integer","minimum":0,"maximum":1440},"buffer_after_minutes":{"type":"integer","minimum":0,"maximum":1440},"slot_interval_minutes":{"type":"integer","minimum":1,"maximum":1440},"min_notice_minutes":{"type":"integer","minimum":0,"maximum":2147483647},"max_horizon_days":{"type":"integer","minimum":1,"maximum":730},"confirmation_policy":{"type":"string","enum":["auto","approval"]}},"required":["duration_minutes","buffer_before_minutes","buffer_after_minutes","slot_interval_minutes","min_notice_minutes","max_horizon_days","confirmation_policy"],"additionalProperties":false}},"required":["timezone","weekly","event_type"],"additionalProperties":false}},"required":["expected_revision","defaults"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"revision":{"type":"integer","minimum":0},"defaults":{"type":"object","properties":{"notifications":{"type":"object","properties":{"session_reminders":{"type":"array","items":{"type":"object","properties":{"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_pack_id":{"type":"string"}},"required":["lead_minutes","template_pack_id"],"additionalProperties":false},"maxItems":3},"event_reminders":{"type":"array","items":{"type":"object","properties":{"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_pack_id":{"type":"string"}},"required":["lead_minutes","template_pack_id"],"additionalProperties":false},"maxItems":3}},"required":["session_reminders","event_reminders"],"additionalProperties":false},"timezone":{"type":"string"},"weekly":{"type":"array","items":{"type":"object","properties":{"weekday":{"type":"integer","minimum":0,"maximum":6,"description":"Monday = 0, Sunday = 6"},"blocks":{"type":"array","items":{"type":"object","properties":{"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^(([01]\\d|2[0-3]):[0-5]\\d|24:00)$"}},"required":["start","end"],"additionalProperties":false},"maxItems":12}},"required":["weekday","blocks"],"additionalProperties":false},"maxItems":7},"event_type":{"type":"object","properties":{"duration_minutes":{"type":"integer","minimum":1,"maximum":1440},"buffer_before_minutes":{"type":"integer","minimum":0,"maximum":1440},"buffer_after_minutes":{"type":"integer","minimum":0,"maximum":1440},"slot_interval_minutes":{"type":"integer","minimum":1,"maximum":1440},"min_notice_minutes":{"type":"integer","minimum":0,"maximum":2147483647},"max_horizon_days":{"type":"integer","minimum":1,"maximum":730},"confirmation_policy":{"type":"string","enum":["auto","approval"]}},"required":["duration_minutes","buffer_before_minutes","buffer_after_minutes","slot_interval_minutes","min_notice_minutes","max_horizon_days","confirmation_policy"],"additionalProperties":false}},"required":["timezone","weekly","event_type"],"additionalProperties":false}},"required":["revision","defaults"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/tenant/defaults \\\n  --request PUT \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/tenant/defaults', {\n  method: 'PUT',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"PUT\",\n    \"/v1/tenant/defaults\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('PUT', 'https://api.calendar.anam.app/v1/tenant/defaults', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/notification-profile":{"get":{"operationId":"getV1NotificationProfile","summary":"Read the organization notification routing profile","tags":["configuration"],"description":"Provider-neutral template keys and source signals. No contacts or message content.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"revision":{"type":"integer","minimum":0},"profile":{"type":["object","null"],"properties":{"schema_version":{"type":"number","enum":[1]},"management_links":{"type":"string","enum":["scoped"]},"key":{"type":"string","pattern":"^[a-z][a-z0-9._-]{0,79}$"},"revision":{"type":"string","pattern":"^[a-f0-9]{64}$"},"routes":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","properties":{"event":{"type":"string","minLength":1,"maxLength":100},"recipient":{"type":"string","enum":["recipient","participant","host"]},"template_key":{"type":"string","minLength":1,"maxLength":120},"channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp","sms","inbox"]},"maxItems":4},"when_present":{"type":"array","items":{"type":"string","enum":["appointment_at","previous_appointment_at","manage_url","confirm_url","cancel_url","meeting_url","booking_url","code","frequency","organizer_message","participant_message"]},"maxItems":12},"payload_variables":{"type":"array","items":{"type":"string","enum":["appointment_at","previous_appointment_at","manage_url","confirm_url","cancel_url","meeting_url","booking_url","code","frequency","organizer_message","participant_message"]},"maxItems":12},"payload_variable_channels":{"type":"object","required":["organizer_message","participant_message"],"properties":{"organizer_message":{"type":"array","items":{"type":"string","enum":["email"]},"minItems":1,"maxItems":1},"participant_message":{"type":"array","items":{"type":"string","enum":["email"]},"minItems":1,"maxItems":1}},"additionalProperties":false}},"required":["event","recipient","template_key","channels","payload_variables"],"additionalProperties":false},"maxItems":4}}},"required":["schema_version","key","revision","routes"],"additionalProperties":false}},"required":["revision","profile"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/notification-profile \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/notification-profile', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/notification-profile\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/notification-profile', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]},"put":{"operationId":"putV1NotificationProfile","summary":"Install a reviewed notification routing profile","tags":["configuration"],"description":"CAS and idempotency protect replacement. An installed profile suppresses unmatched legacy message sends. Existing domain records and unrelated organizations are preserved.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expected_revision":{"type":"integer","minimum":0},"profile":{"type":"object","properties":{"schema_version":{"type":"number","enum":[1]},"management_links":{"type":"string","enum":["scoped"]},"key":{"type":"string","pattern":"^[a-z][a-z0-9._-]{0,79}$"},"revision":{"type":"string","pattern":"^[a-f0-9]{64}$"},"routes":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","properties":{"event":{"type":"string","minLength":1,"maxLength":100},"recipient":{"type":"string","enum":["recipient","participant","host"]},"template_key":{"type":"string","minLength":1,"maxLength":120},"channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp","sms","inbox"]},"maxItems":4},"when_present":{"type":"array","items":{"type":"string","enum":["appointment_at","previous_appointment_at","manage_url","confirm_url","cancel_url","meeting_url","booking_url","code","frequency","organizer_message","participant_message"]},"maxItems":12},"payload_variables":{"type":"array","items":{"type":"string","enum":["appointment_at","previous_appointment_at","manage_url","confirm_url","cancel_url","meeting_url","booking_url","code","frequency","organizer_message","participant_message"]},"maxItems":12},"payload_variable_channels":{"type":"object","required":["organizer_message","participant_message"],"properties":{"organizer_message":{"type":"array","items":{"type":"string","enum":["email"]},"minItems":1,"maxItems":1},"participant_message":{"type":"array","items":{"type":"string","enum":["email"]},"minItems":1,"maxItems":1}},"additionalProperties":false}},"required":["event","recipient","template_key","channels","payload_variables"],"additionalProperties":false},"maxItems":4}}},"required":["schema_version","key","revision","routes"],"additionalProperties":false}},"required":["expected_revision","profile"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"revision":{"type":"integer","minimum":0},"profile":{"type":["object","null"],"properties":{"schema_version":{"type":"number","enum":[1]},"management_links":{"type":"string","enum":["scoped"]},"key":{"type":"string","pattern":"^[a-z][a-z0-9._-]{0,79}$"},"revision":{"type":"string","pattern":"^[a-f0-9]{64}$"},"routes":{"type":"object","additionalProperties":{"type":"array","items":{"type":"object","properties":{"event":{"type":"string","minLength":1,"maxLength":100},"recipient":{"type":"string","enum":["recipient","participant","host"]},"template_key":{"type":"string","minLength":1,"maxLength":120},"channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp","sms","inbox"]},"maxItems":4},"when_present":{"type":"array","items":{"type":"string","enum":["appointment_at","previous_appointment_at","manage_url","confirm_url","cancel_url","meeting_url","booking_url","code","frequency","organizer_message","participant_message"]},"maxItems":12},"payload_variables":{"type":"array","items":{"type":"string","enum":["appointment_at","previous_appointment_at","manage_url","confirm_url","cancel_url","meeting_url","booking_url","code","frequency","organizer_message","participant_message"]},"maxItems":12},"payload_variable_channels":{"type":"object","required":["organizer_message","participant_message"],"properties":{"organizer_message":{"type":"array","items":{"type":"string","enum":["email"]},"minItems":1,"maxItems":1},"participant_message":{"type":"array","items":{"type":"string","enum":["email"]},"minItems":1,"maxItems":1}},"additionalProperties":false}},"required":["event","recipient","template_key","channels","payload_variables"],"additionalProperties":false},"maxItems":4}}},"required":["schema_version","key","revision","routes"],"additionalProperties":false}},"required":["revision","profile"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/notification-profile \\\n  --request PUT \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/notification-profile', {\n  method: 'PUT',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"PUT\",\n    \"/v1/notification-profile\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('PUT', 'https://api.calendar.anam.app/v1/notification-profile', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/tenant/display-preferences":{"get":{"operationId":"getV1TenantDisplayPreferences","summary":"Read inherited tenant display preferences","tags":["tenants"],"description":"Read inherited tenant display preferences","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"revision":{"type":"integer","minimum":0},"defaults":{"type":"object","properties":{"show_cancelled":{"type":"boolean"},"show_rescheduled":{"type":"boolean"},"show_confirmed":{"type":"boolean"}},"required":["show_cancelled","show_rescheduled","show_confirmed"],"additionalProperties":false},"overrides":{"type":"object","properties":{"show_cancelled":{"type":"boolean"},"show_rescheduled":{"type":"boolean"},"show_confirmed":{"type":"boolean"}},"additionalProperties":false},"effective":{"type":"object","properties":{"show_cancelled":{"type":"boolean"},"show_rescheduled":{"type":"boolean"},"show_confirmed":{"type":"boolean"}},"required":["show_cancelled","show_rescheduled","show_confirmed"],"additionalProperties":false}},"required":["revision","defaults","overrides","effective"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/tenant/display-preferences \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/tenant/display-preferences', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/tenant/display-preferences\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/tenant/display-preferences', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]},"put":{"operationId":"putV1TenantDisplayPreferences","summary":"Replace tenant display overrides","tags":["tenants"],"description":"Omit any field to resume inheritance. Applies only to calendar reads that opt in to display preferences.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expected_revision":{"type":"integer","minimum":0},"overrides":{"type":"object","properties":{"show_cancelled":{"type":"boolean"},"show_rescheduled":{"type":"boolean"},"show_confirmed":{"type":"boolean"}},"additionalProperties":false}},"required":["expected_revision","overrides"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"revision":{"type":"integer","minimum":0},"defaults":{"type":"object","properties":{"show_cancelled":{"type":"boolean"},"show_rescheduled":{"type":"boolean"},"show_confirmed":{"type":"boolean"}},"required":["show_cancelled","show_rescheduled","show_confirmed"],"additionalProperties":false},"overrides":{"type":"object","properties":{"show_cancelled":{"type":"boolean"},"show_rescheduled":{"type":"boolean"},"show_confirmed":{"type":"boolean"}},"additionalProperties":false},"effective":{"type":"object","properties":{"show_cancelled":{"type":"boolean"},"show_rescheduled":{"type":"boolean"},"show_confirmed":{"type":"boolean"}},"required":["show_cancelled","show_rescheduled","show_confirmed"],"additionalProperties":false}},"required":["revision","defaults","overrides","effective"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/tenant/display-preferences \\\n  --request PUT \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/tenant/display-preferences', {\n  method: 'PUT',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"PUT\",\n    \"/v1/tenant/display-preferences\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('PUT', 'https://api.calendar.anam.app/v1/tenant/display-preferences', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/hosts/{hostId}/display-preferences":{"get":{"operationId":"getV1HostsByHostidDisplayPreferences","summary":"Read inherited calendar display preferences","tags":["configuration"],"description":"Read inherited calendar display preferences","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"hostId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"revision":{"type":"integer","minimum":0},"defaults":{"type":"object","properties":{"show_cancelled":{"type":"boolean"},"show_rescheduled":{"type":"boolean"},"show_confirmed":{"type":"boolean"}},"required":["show_cancelled","show_rescheduled","show_confirmed"],"additionalProperties":false},"overrides":{"type":"object","properties":{"show_cancelled":{"type":"boolean"},"show_rescheduled":{"type":"boolean"},"show_confirmed":{"type":"boolean"}},"additionalProperties":false},"effective":{"type":"object","properties":{"show_cancelled":{"type":"boolean"},"show_rescheduled":{"type":"boolean"},"show_confirmed":{"type":"boolean"}},"required":["show_cancelled","show_rescheduled","show_confirmed"],"additionalProperties":false}},"required":["revision","defaults","overrides","effective"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/display-preferences \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/display-preferences', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/hosts/00000000-0000-4000-8000-000000000000/display-preferences\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/display-preferences', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]},"put":{"operationId":"putV1HostsByHostidDisplayPreferences","summary":"Replace calendar display overrides","tags":["configuration"],"description":"Omit any field to resume inheritance. Applies only to calendar reads that opt in to display preferences.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expected_revision":{"type":"integer","minimum":0},"overrides":{"type":"object","properties":{"show_cancelled":{"type":"boolean"},"show_rescheduled":{"type":"boolean"},"show_confirmed":{"type":"boolean"}},"additionalProperties":false}},"required":["expected_revision","overrides"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"hostId","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"revision":{"type":"integer","minimum":0},"defaults":{"type":"object","properties":{"show_cancelled":{"type":"boolean"},"show_rescheduled":{"type":"boolean"},"show_confirmed":{"type":"boolean"}},"required":["show_cancelled","show_rescheduled","show_confirmed"],"additionalProperties":false},"overrides":{"type":"object","properties":{"show_cancelled":{"type":"boolean"},"show_rescheduled":{"type":"boolean"},"show_confirmed":{"type":"boolean"}},"additionalProperties":false},"effective":{"type":"object","properties":{"show_cancelled":{"type":"boolean"},"show_rescheduled":{"type":"boolean"},"show_confirmed":{"type":"boolean"}},"required":["show_cancelled","show_rescheduled","show_confirmed"],"additionalProperties":false}},"required":["revision","defaults","overrides","effective"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/display-preferences \\\n  --request PUT \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/display-preferences', {\n  method: 'PUT',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"PUT\",\n    \"/v1/hosts/00000000-0000-4000-8000-000000000000/display-preferences\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('PUT', 'https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/display-preferences', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/hosts/{hostId}/notification-policy":{"get":{"operationId":"getV1HostsByHostidNotificationPolicy","summary":"Read inherited calendar notification policy","tags":["notifications"],"description":"Read inherited calendar notification policy","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"hostId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"revision":{"type":"integer","minimum":0},"defaults":{"type":"object","properties":{"session_reminders":{"type":"array","items":{"type":"object","properties":{"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_pack_id":{"type":"string"}},"required":["lead_minutes","template_pack_id"],"additionalProperties":false},"maxItems":3},"event_reminders":{"type":"array","items":{"type":"object","properties":{"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_pack_id":{"type":"string"}},"required":["lead_minutes","template_pack_id"],"additionalProperties":false},"maxItems":3}},"required":["session_reminders","event_reminders"],"additionalProperties":false},"overrides":{"type":"object","properties":{"session_reminders":{"type":"array","items":{"type":"object","properties":{"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_pack_id":{"type":"string"}},"required":["lead_minutes","template_pack_id"],"additionalProperties":false},"maxItems":3},"event_reminders":{"type":"array","items":{"type":"object","properties":{"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_pack_id":{"type":"string"}},"required":["lead_minutes","template_pack_id"],"additionalProperties":false},"maxItems":3}},"additionalProperties":false},"effective":{"type":"object","properties":{"session_reminders":{"type":"array","items":{"type":"object","properties":{"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_pack_id":{"type":"string"}},"required":["lead_minutes","template_pack_id"],"additionalProperties":false},"maxItems":3},"event_reminders":{"type":"array","items":{"type":"object","properties":{"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_pack_id":{"type":"string"}},"required":["lead_minutes","template_pack_id"],"additionalProperties":false},"maxItems":3}},"required":["session_reminders","event_reminders"],"additionalProperties":false},"packs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"audience":{"type":"string","enum":["patient","host"]},"channels":{"type":"object","additionalProperties":{"type":"string"}}},"required":["id","audience","channels"],"additionalProperties":false}}},"required":["revision","defaults","overrides","effective","packs"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/notification-policy \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/notification-policy', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/hosts/00000000-0000-4000-8000-000000000000/notification-policy\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/notification-policy', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]},"put":{"operationId":"putV1HostsByHostidNotificationPolicy","summary":"Set calendar overrides; omit a field to resume tenant inheritance","tags":["notifications"],"description":"Applies to new notification intentions, including new/replanned occurrences. Already accepted reminders are not resent. Existing explicit event-type reminder offsets take precedence.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expected_revision":{"type":"integer","minimum":0},"overrides":{"type":"object","properties":{"session_reminders":{"type":"array","items":{"type":"object","properties":{"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_pack_id":{"type":"string"}},"required":["lead_minutes","template_pack_id"],"additionalProperties":false},"maxItems":3},"event_reminders":{"type":"array","items":{"type":"object","properties":{"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_pack_id":{"type":"string"}},"required":["lead_minutes","template_pack_id"],"additionalProperties":false},"maxItems":3}},"additionalProperties":false}},"required":["expected_revision","overrides"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"hostId","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"revision":{"type":"integer","minimum":0},"defaults":{"type":"object","properties":{"session_reminders":{"type":"array","items":{"type":"object","properties":{"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_pack_id":{"type":"string"}},"required":["lead_minutes","template_pack_id"],"additionalProperties":false},"maxItems":3},"event_reminders":{"type":"array","items":{"type":"object","properties":{"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_pack_id":{"type":"string"}},"required":["lead_minutes","template_pack_id"],"additionalProperties":false},"maxItems":3}},"required":["session_reminders","event_reminders"],"additionalProperties":false},"overrides":{"type":"object","properties":{"session_reminders":{"type":"array","items":{"type":"object","properties":{"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_pack_id":{"type":"string"}},"required":["lead_minutes","template_pack_id"],"additionalProperties":false},"maxItems":3},"event_reminders":{"type":"array","items":{"type":"object","properties":{"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_pack_id":{"type":"string"}},"required":["lead_minutes","template_pack_id"],"additionalProperties":false},"maxItems":3}},"additionalProperties":false},"effective":{"type":"object","properties":{"session_reminders":{"type":"array","items":{"type":"object","properties":{"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_pack_id":{"type":"string"}},"required":["lead_minutes","template_pack_id"],"additionalProperties":false},"maxItems":3},"event_reminders":{"type":"array","items":{"type":"object","properties":{"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_pack_id":{"type":"string"}},"required":["lead_minutes","template_pack_id"],"additionalProperties":false},"maxItems":3}},"required":["session_reminders","event_reminders"],"additionalProperties":false},"packs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"audience":{"type":"string","enum":["patient","host"]},"channels":{"type":"object","additionalProperties":{"type":"string"}}},"required":["id","audience","channels"],"additionalProperties":false}}},"required":["revision","defaults","overrides","effective","packs"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/notification-policy \\\n  --request PUT \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/notification-policy', {\n  method: 'PUT',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"PUT\",\n    \"/v1/hosts/00000000-0000-4000-8000-000000000000/notification-policy\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('PUT', 'https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/notification-policy', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/notification-packs":{"get":{"operationId":"getV1NotificationPacks","summary":"List available reminder packs","tags":["notifications"],"description":"List available reminder packs","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"packs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"audience":{"type":"string","enum":["patient","host"]},"channels":{"type":"object","additionalProperties":{"type":"string"}}},"required":["id","audience","channels"],"additionalProperties":false}}},"required":["packs"],"additionalProperties":false}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/notification-packs \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/notification-packs', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/notification-packs\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/notification-packs', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/hosts/{hostId}/event-types/{eventTypeId}/defaults":{"get":{"operationId":"getV1HostsByHostidEventTypesByEventtypeidDefaults","summary":"Read explicit default inheritance for one calendar and event type","tags":["tenants"],"description":"Read explicit default inheritance for one calendar and event type","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"hostId","required":true},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"eventTypeId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"host_revision":{"type":"integer","minimum":0},"event_type_revision":{"type":"integer","minimum":0},"host_fields":{"type":"array","items":{"type":"string","enum":["timezone","weekly"]},"maxItems":2},"event_type_fields":{"type":"array","items":{"type":"string","enum":["duration_minutes","buffer_before_minutes","buffer_after_minutes","slot_interval_minutes","min_notice_minutes","max_horizon_days","confirmation_policy"]},"maxItems":7}},"required":["host_revision","event_type_revision","host_fields","event_type_fields"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/event-types/00000000-0000-4000-8000-000000000000/defaults \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/event-types/00000000-0000-4000-8000-000000000000/defaults', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/hosts/00000000-0000-4000-8000-000000000000/event-types/00000000-0000-4000-8000-000000000000/defaults\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/event-types/00000000-0000-4000-8000-000000000000/defaults', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]},"put":{"operationId":"putV1HostsByHostidEventTypesByEventtypeidDefaults","summary":"Select inherited fields, or pin their current values as overrides","tags":["tenants"],"description":"Existing resources start with explicit values. Inherited fields follow tenant updates. Editing a value through existing APIs makes that field an override. Weekly schedule is one field; date exceptions remain independent. Updates never move or cancel booked occurrences. Both configuration revisions and Idempotency-Key are required.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expected_host_revision":{"type":"integer","minimum":0},"expected_event_type_revision":{"type":"integer","minimum":0},"host_fields":{"type":"array","items":{"type":"string","enum":["timezone","weekly"]},"maxItems":2},"event_type_fields":{"type":"array","items":{"type":"string","enum":["duration_minutes","buffer_before_minutes","buffer_after_minutes","slot_interval_minutes","min_notice_minutes","max_horizon_days","confirmation_policy"]},"maxItems":7}},"required":["expected_host_revision","expected_event_type_revision","host_fields","event_type_fields"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"hostId","required":true},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"eventTypeId","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"host_revision":{"type":"integer","minimum":0},"event_type_revision":{"type":"integer","minimum":0},"host_fields":{"type":"array","items":{"type":"string","enum":["timezone","weekly"]},"maxItems":2},"event_type_fields":{"type":"array","items":{"type":"string","enum":["duration_minutes","buffer_before_minutes","buffer_after_minutes","slot_interval_minutes","min_notice_minutes","max_horizon_days","confirmation_policy"]},"maxItems":7}},"required":["host_revision","event_type_revision","host_fields","event_type_fields"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/event-types/00000000-0000-4000-8000-000000000000/defaults \\\n  --request PUT \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/event-types/00000000-0000-4000-8000-000000000000/defaults', {\n  method: 'PUT',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"PUT\",\n    \"/v1/hosts/00000000-0000-4000-8000-000000000000/event-types/00000000-0000-4000-8000-000000000000/defaults\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('PUT', 'https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/event-types/00000000-0000-4000-8000-000000000000/defaults', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/provider-sync-operations":{"get":{"operationId":"getV1ProviderSyncOperations","summary":"List provider projection operation receipts for a selected tenant","tags":["operations"],"description":"List provider projection operation receipts for a selected tenant","parameters":[{"schema":{"type":"string","enum":["pending","running","failed","completed","dead"]},"in":"query","name":"state","required":false},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"cursor","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"connection_id":{"type":"string","format":"uuid"},"occurrence_id":{"type":"string","format":"uuid"},"desired_revision":{"type":"integer"},"state":{"type":"string","enum":["pending","running","failed","completed","dead"]},"attempt":{"type":"integer"},"max_attempts":{"type":"integer"},"next_attempt_at":{"type":"string","format":"date-time"},"completed_at":{"type":["string","null"],"format":"date-time"},"updated_at":{"type":"string","format":"date-time"},"failure_code":{"type":["string","null"],"enum":["provider_authentication_failed","provider_temporarily_unavailable","provider_projection_failed"]}},"required":["id","connection_id","occurrence_id","desired_revision","state","attempt","max_attempts","next_attempt_at","completed_at","updated_at","failure_code"],"additionalProperties":false}},"next_cursor":{"type":["string","null"],"format":"uuid"}},"required":["data","next_cursor"],"additionalProperties":false}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/provider-sync-operations \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/provider-sync-operations', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/provider-sync-operations\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/provider-sync-operations', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/provider-sync-operations/{id}/replay":{"post":{"operationId":"postV1ProviderSyncOperationsByIdReplay","summary":"Replay one dead provider projection operation","tags":["operations"],"description":"Loads current canonical occurrence state; the prior attempt evidence remains in tenant audit. Idempotent receipt commits with replay intent.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":true}],"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"operation_id":{"type":"string","format":"uuid"},"state":{"type":"string","enum":["pending"]}},"required":["operation_id","state"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/provider-sync-operations/00000000-0000-4000-8000-000000000000/replay \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/provider-sync-operations/00000000-0000-4000-8000-000000000000/replay', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/provider-sync-operations/00000000-0000-4000-8000-000000000000/replay\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/provider-sync-operations/00000000-0000-4000-8000-000000000000/replay', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/provider-sync-connections":{"get":{"operationId":"getV1ProviderSyncConnections","summary":"Inspect provider cooldown and recovery state","tags":["operations"],"description":"Inspect provider cooldown and recovery state","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"cursor","required":false},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":25},"in":"query","name":"limit","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"provider":{"type":"string"},"status":{"type":"string"},"failures":{"type":"integer"},"retry_at":{"type":["string","null"],"format":"date-time"},"recovery_required_at":{"type":["string","null"],"format":"date-time"},"failure_code":{"type":["string","null"]}},"required":["id","host_id","provider","status","failures","retry_at","recovery_required_at","failure_code"],"additionalProperties":false}},"next_cursor":{"type":["string","null"],"format":"uuid"}},"required":["data","next_cursor"],"additionalProperties":false}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/provider-sync-connections \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/provider-sync-connections', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/provider-sync-connections\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/provider-sync-connections', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/provider-sync-connections/{id}/replay":{"post":{"operationId":"postV1ProviderSyncConnectionsByIdReplay","summary":"Recover a provider connection parked after seven failed generations","tags":["operations"],"description":"Recover a provider connection parked after seven failed generations","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":true}],"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"connection_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["active","connecting"]}},"required":["connection_id","status"],"additionalProperties":false}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/provider-sync-connections/00000000-0000-4000-8000-000000000000/replay \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/provider-sync-connections/00000000-0000-4000-8000-000000000000/replay', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/provider-sync-connections/00000000-0000-4000-8000-000000000000/replay\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/provider-sync-connections/00000000-0000-4000-8000-000000000000/replay', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/hosts/{hostId}/absences/impact":{"get":{"operationId":"getV1HostsByHostidAbsencesImpact","summary":"Preview existing bookings within a proposed closure","tags":["configuration"],"description":"Preview existing bookings within a proposed closure","parameters":[{"schema":{"type":"string","format":"date-time"},"in":"query","name":"from","required":true,"description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"to","required":true,"description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"hostId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"total":{"type":"integer"},"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"booking_id":{"type":"string","format":"uuid"},"starts_at":{"type":"string"},"ends_at":{"type":"string"}},"required":["id","booking_id","starts_at","ends_at"],"additionalProperties":false},"maxItems":100}},"required":["total","items"],"additionalProperties":false}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/absences/impact \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/absences/impact', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/hosts/00000000-0000-4000-8000-000000000000/absences/impact\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/absences/impact', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/hosts/{hostId}/absences":{"post":{"operationId":"postV1HostsByHostidAbsences","summary":"Close a host calendar for a vacation or a long block","tags":["configuration"],"description":"With on_conflict=reject, refuses occupied intervals without cancelling or releasing anything. With on_conflict=cancel (compatibility default), cancels live occurrences that overlap the span, including the dates of a recurring series that fall inside, and leaves the rest of the series in place. The closed time is not offered to anyone. booking.cancelled carries cause host_absence so an integrator can tell it from a chosen cancellation. Each displaced attendee joins that event type's waitlist ahead of people who joined on their own, and is offered the next slot a later cancellation frees. Ending the absence does not restore the sessions and does not emit offers for the days that were closed.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"starts_at":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"ends_at":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"on_conflict":{"type":"string","enum":["cancel","reject","preserve"],"default":"cancel","description":"preserve keeps existing occupancy and prevents new claims; reject refuses occupied intervals; cancel uses the explicit absence cancellation workflow."},"reason":{"type":"string","enum":["vacation","block"],"description":"vacation is time off. block is a long closure that is not time off."}},"required":["starts_at","ends_at","reason"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"hostId","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"starts_at":{"type":"string"},"ends_at":{"type":"string"},"reason":{"type":["string","null"],"enum":["vacation","block"]},"cancelled_occurrence_ids":{"type":"array","items":{"type":"string","format":"uuid"}},"released_hold_ids":{"type":"array","items":{"type":"string","format":"uuid"}}},"required":["id","host_id","starts_at","ends_at","reason","cancelled_occurrence_ids","released_hold_ids"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/absences \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/absences', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/hosts/00000000-0000-4000-8000-000000000000/absences\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/absences', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]},"get":{"operationId":"getV1HostsByHostidAbsences","summary":"List a host's blackouts","tags":["configuration"],"description":"List a host's blackouts","parameters":[{"schema":{"type":"string","format":"date-time"},"in":"query","name":"from","required":false,"description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"to","required":false,"description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"hostId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"next_cursor":{"type":["string","null"],"format":"uuid"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"starts_at":{"type":"string"},"ends_at":{"type":"string"},"reason":{"type":["string","null"]}},"required":["id","starts_at","ends_at","reason"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/absences \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/absences', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/hosts/00000000-0000-4000-8000-000000000000/absences\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/absences', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/hosts/{hostId}/absences/{absenceId}":{"delete":{"operationId":"deleteV1HostsByHostidAbsencesByAbsenceid","summary":"End an absence without restoring the sessions it cancelled","tags":["configuration"],"description":"End an absence without restoring the sessions it cancelled","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"hostId","required":true},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"absenceId","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"occurrences_restored":{"type":"number","enum":[0]}},"required":["id","occurrences_restored"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/absences/00000000-0000-4000-8000-000000000000 \\\n  --request DELETE \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/absences/00000000-0000-4000-8000-000000000000', {\n  method: 'DELETE',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"DELETE\",\n    \"/v1/hosts/00000000-0000-4000-8000-000000000000/absences/00000000-0000-4000-8000-000000000000\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('DELETE', 'https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/absences/00000000-0000-4000-8000-000000000000', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/session-packages":{"post":{"operationId":"postV1SessionPackages","summary":"Open a balance of appointments","tags":["scheduling"],"description":"Records how many times one participant may book one event type, and optionally when new bookings stop drawing from it. Cancelling an occurrence the agenda accepted returns the draw. Moving an occurrence does not draw again. A no-show keeps the draw.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"event_type_id":{"type":"string","format":"uuid"},"attendee_ref":{"type":"string","minLength":1,"maxLength":255},"quantity":{"type":"integer","minimum":1,"maximum":10000},"expires_at":{"type":["string","null"],"format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"}},"required":["event_type_id","attendee_ref","quantity"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"event_type_id":{"type":"string","format":"uuid"},"attendee_ref":{"type":"string"},"quantity":{"type":"integer"},"remaining":{"type":"integer"},"expires_at":{"type":["string","null"]},"expired":{"type":"boolean"},"created_at":{"type":"string"}},"required":["id","event_type_id","attendee_ref","quantity","remaining","expires_at","expired","created_at"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/session-packages \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/session-packages', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/session-packages\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/session-packages', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]},"get":{"operationId":"getV1SessionPackages","summary":"List appointment balances","tags":["scheduling"],"description":"List appointment balances","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":255},"in":"query","name":"attendee_ref","required":false},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"event_type_id","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"event_type_id":{"type":"string","format":"uuid"},"attendee_ref":{"type":"string"},"quantity":{"type":"integer"},"remaining":{"type":"integer"},"expires_at":{"type":["string","null"]},"expired":{"type":"boolean"},"created_at":{"type":"string"}},"required":["id","event_type_id","attendee_ref","quantity","remaining","expires_at","expired","created_at"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/session-packages \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/session-packages', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/session-packages\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/session-packages', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/session-packages/{packageId}/top-up":{"post":{"operationId":"postV1SessionPackagesByPackageidTopUp","summary":"Add appointments to a balance","tags":["scheduling"],"description":"Add appointments to a balance","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"add":{"type":"integer","minimum":1,"maximum":10000}},"required":["add"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"packageId","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"event_type_id":{"type":"string","format":"uuid"},"attendee_ref":{"type":"string"},"quantity":{"type":"integer"},"remaining":{"type":"integer"},"expires_at":{"type":["string","null"]},"expired":{"type":"boolean"},"created_at":{"type":"string"}},"required":["id","event_type_id","attendee_ref","quantity","remaining","expires_at","expired","created_at"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/session-packages/00000000-0000-4000-8000-000000000000/top-up \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/session-packages/00000000-0000-4000-8000-000000000000/top-up', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/session-packages/00000000-0000-4000-8000-000000000000/top-up\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/session-packages/00000000-0000-4000-8000-000000000000/top-up', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/session-packages/{packageId}":{"get":{"operationId":"getV1SessionPackagesByPackageid","summary":"Read one appointment balance","tags":["scheduling"],"description":"Read one appointment balance","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"packageId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"event_type_id":{"type":"string","format":"uuid"},"attendee_ref":{"type":"string"},"quantity":{"type":"integer"},"remaining":{"type":"integer"},"expires_at":{"type":["string","null"]},"expired":{"type":"boolean"},"created_at":{"type":"string"}},"required":["id","event_type_id","attendee_ref","quantity","remaining","expires_at","expired","created_at"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/session-packages/00000000-0000-4000-8000-000000000000 \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/session-packages/00000000-0000-4000-8000-000000000000', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/session-packages/00000000-0000-4000-8000-000000000000\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/session-packages/00000000-0000-4000-8000-000000000000', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/organization":{"patch":{"operationId":"patchV1Organization","summary":"Update organization scheduling settings","tags":["configuration"],"description":"Organization credentials only. allow_host_substitution enables host substitution. The public occurrence route confines both hosts to the selected tenant. The booking stays with the original host. The cover must be free. The vacation of either host still closes that host and is not offered as a slot.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"allow_host_substitution":{"type":"boolean"}},"required":["allow_host_substitution"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"allow_host_substitution":{"type":"boolean"}},"required":["allow_host_substitution"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/organization \\\n  --request PATCH \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/organization', {\n  method: 'PATCH',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"PATCH\",\n    \"/v1/organization\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('PATCH', 'https://api.calendar.anam.app/v1/organization', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/occurrences/{occurrenceId}/substitute":{"post":{"operationId":"postV1OccurrencesByOccurrenceidSubstitute","summary":"Hand one occurrence to another host","tags":["scheduling"],"description":"Requires the organization setting allow_host_substitution. host_id is another host in the selected tenant, or the booking host to return the occurrence. Cross-tenant substitution is unsupported by this route, including for organization credentials; it would require separate authorization for both Accounts. A confirmed occurrence only. The cover is claimed on their own calendar, so a time they already have is refused. The attendee is not renamed. booking.substituted tells the integrator; this service does not invent a message for the change of host.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"host_id":{"type":"string","format":"uuid"}},"required":["host_id"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"occurrenceId","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"occurrence_id":{"type":"string","format":"uuid"},"booking_id":{"type":"string","format":"uuid"},"from_host_id":{"type":"string","format":"uuid"},"to_host_id":{"type":"string","format":"uuid"}},"required":["occurrence_id","booking_id","from_host_id","to_host_id"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000/substitute \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000/substitute', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/occurrences/00000000-0000-4000-8000-000000000000/substitute\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000/substitute', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/console-sessions":{"post":{"operationId":"postV1ConsoleSessions","summary":"Exchange an API credential for a console session","tags":["console"],"description":"The mechanism that lets the professional's console be sold to a second customer as configuration rather than as a fork: the integrator's backend swaps its credential for a short-lived token scoped to one host, so the credential that reaches every professional never enters a browser and this service never learns who the person behind the host is. Backed by a row rather than signed, because a session someone closes has to stop working now rather than when its TTL runs out. `acting_as` is required and stored on that row: the service authenticated an API credential, not a person, and a support employee opening this screen must not be recorded as the psychologist. The token is returned once and is not written to the audit hook.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"host_id":{"type":"string","format":"uuid"},"scopes":{"type":"array","items":{"type":"string","enum":["me:read","me:write","booking:read","booking:write"]},"maxItems":4,"description":"Exact actions delegated to this host. Omission preserves the legacy console actions; an empty array grants no resource actions."},"acting_as":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["host"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["operator"]},"operator_ref":{"type":"string","minLength":1,"maxLength":200},"reason":{"type":"string","minLength":1,"maxLength":2000}},"required":["kind","operator_ref","reason"],"additionalProperties":false}],"description":"Who will hold the session. Required, no default. host is the professional; operator is anyone else and requires operator_ref and reason."},"asserted_by_integrator":{"type":"object","properties":{"auth_method":{"type":"string","maxLength":64},"mfa":{"type":"boolean"},"authenticated_at":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"}},"additionalProperties":false,"description":"What the integrator claims about how it authenticated the person. Not verified here, and not stored as fact; the audit payload nests it so the trail says the integrator asserted it."},"external_authority_lease":{"type":"object","properties":{"owner_ref":{"type":"string","format":"uuid"},"seconds":{"type":"integer","minimum":5,"maximum":30}},"required":["owner_ref","seconds"],"additionalProperties":false,"description":"Opt-in integrator authority liveness. The original issuer must renew this short CAS lease; expiry rejects the already issued bearer independently of its token TTL."},"ttl_seconds":{"type":"integer","minimum":60,"maximum":86400,"description":"Clamped to the configured ceiling rather than refused, so the integrator does not have to carry our limit."},"locale":{"type":["string","null"],"maxLength":35}},"required":["host_id","acting_as"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"token":{"type":"string"},"expires_at":{"type":"string"},"host_id":{"type":"string","format":"uuid"},"tenant_id":{"type":"string","format":"uuid"},"scopes":{"type":"array","items":{"type":"string"}},"acting_as":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["host"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["operator"]},"operator_ref":{"type":"string"},"reason":{"type":"string"}},"required":["kind","operator_ref","reason"],"additionalProperties":false}]},"patient_capacity":{"type":"string","enum":["capacity_professional","capacity_support"]},"authority_revision":{"type":["integer","null"],"exclusiveMinimum":true,"minimum":0},"authority_valid_until":{"type":["string","null"],"format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"}},"required":["id","token","expires_at","host_id","tenant_id","scopes","acting_as","patient_capacity"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"428":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/console-sessions \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/console-sessions', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/console-sessions\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/console-sessions', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/console-sessions/{id}":{"delete":{"operationId":"deleteV1ConsoleSessionsById","summary":"Revoke a console session","tags":["console"],"description":"Revocation is why sessions are rows rather than signatures. A professional signing out of a shared machine, or an integrator off-boarding someone, needs the token dead on the next request; a session may always revoke itself, which is what the sign-out button calls.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"204":{"description":"Default Response","content":{"application/json":{"schema":{"enum":["null"]}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"428":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/console-sessions/00000000-0000-4000-8000-000000000000 \\\n  --request DELETE \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/console-sessions/00000000-0000-4000-8000-000000000000', {\n  method: 'DELETE',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"DELETE\",\n    \"/v1/console-sessions/00000000-0000-4000-8000-000000000000\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('DELETE', 'https://api.calendar.anam.app/v1/console-sessions/00000000-0000-4000-8000-000000000000', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/console-sessions/{id}/authority":{"get":{"operationId":"getV1ConsoleSessionsByIdAuthority","summary":"Read the current lease receipt for the original integrator issuer","tags":["console"],"description":"Read the current lease receipt for the original integrator issuer","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"owner_ref","required":true},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"authority_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0},"authority_valid_until":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"}},"required":["id","authority_revision","authority_valid_until"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"428":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/console-sessions/00000000-0000-4000-8000-000000000000/authority \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/console-sessions/00000000-0000-4000-8000-000000000000/authority', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/console-sessions/00000000-0000-4000-8000-000000000000/authority\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/console-sessions/00000000-0000-4000-8000-000000000000/authority', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]},"post":{"operationId":"postV1ConsoleSessionsByIdAuthority","summary":"Renew an opt-in external authority lease with exact issuer and CAS ownership","tags":["console"],"description":"An operational liveness lease, separate from token TTL. No idempotency key is needed: owner_ref and expected_revision identify one renewal. A duplicate of the immediately previous revision returns its original receipt. Expired or revoked grants cannot be revived.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"owner_ref":{"type":"string","format":"uuid"},"expected_revision":{"type":"integer","exclusiveMinimum":true,"minimum":-9007199254740991,"maximum":9007199254740991}},"required":["owner_ref","expected_revision"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"authority_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0},"authority_valid_until":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"}},"required":["id","authority_revision","authority_valid_until"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"428":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/console-sessions/00000000-0000-4000-8000-000000000000/authority \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/console-sessions/00000000-0000-4000-8000-000000000000/authority', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/console-sessions/00000000-0000-4000-8000-000000000000/authority\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/console-sessions/00000000-0000-4000-8000-000000000000/authority', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/me/session":{"get":{"operationId":"getV1MeSession","summary":"What this console session grants","tags":["console"],"description":"The console calls this on load to learn which host it is pinned to and what it may do, instead of inferring either from the token or from configuration it was handed separately.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"session_id":{"type":"string","format":"uuid"},"tenant_id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"scopes":{"type":"array","items":{"type":"string"}},"capabilities":{"type":"array","items":{"type":"string"}},"locale":{"type":["string","null"]},"issued_at":{"type":"string"},"expires_at":{"type":"string"},"acting_as":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["host"]}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["operator"]},"operator_ref":{"type":"string"},"reason":{"type":"string"}},"required":["kind","operator_ref","reason"],"additionalProperties":false}]},"patient_capacity":{"type":"string","enum":["capacity_professional","capacity_support"],"description":"The capacity a patient notification must name for a read under this session. Derived from acting_as, not from the token."}},"required":["session_id","tenant_id","host_id","scopes","capabilities","locale","issued_at","expires_at","acting_as","patient_capacity"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"428":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/me/session \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/me/session', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/me/session\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/me/session', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/me":{"get":{"operationId":"getV1Me","summary":"The professional, as their own console sees them","tags":["console"],"description":"One call to open a screen: who the host is, what their calendar connections are doing, and what this caller is allowed to change. `capabilities` is derived from the token rather than restated by the console, so a read-only credential cannot render buttons that will 403. The ETag is a hash of the editable host fields (label, timezone, status, volume caps). It is not availability_epoch: that counter moves when a patient books, and a concurrency token that moves when nobody edited the configuration protects nothing.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"host_id","required":false,"description":"Which host an API credential is acting on. Ignored by a console session, which is pinned to one host by its token, and refused with 403 if it names a different one. Optional when the professional's tenant has exactly one host, which is the normal case."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"host":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"external_ref":{"type":["string","null"]},"display_label":{"type":"string"},"public_profile":{"type":"object","properties":{"show_logo":{"type":"boolean"},"professional_name":{"type":["string","null"],"minLength":1,"maxLength":200,"pattern":"^[^<>\\p{Cc}]+$"},"email_message":{"type":["string","null"],"maxLength":1000,"pattern":"^[^<>\\u0000-\\u0008\\u000B\\u000C\\u000E-\\u001F\\u007F\\u202A-\\u202E\\u2066-\\u2069]*$"},"calendar_name":{"type":["string","null"],"minLength":1,"maxLength":200,"pattern":"^[^<>\\p{Cc}]+$"},"registration":{"type":["string","null"],"minLength":1,"maxLength":80,"pattern":"^[^<>\\p{Cc}]+$"},"profession":{"type":["string","null"],"minLength":1,"maxLength":120,"pattern":"^[^<>\\p{Cc}]+$"},"photo_url":{"type":["string","null"],"maxLength":2048,"format":"uri"},"email":{"type":["string","null"],"maxLength":254,"format":"email"},"phone":{"type":["string","null"],"pattern":"^\\+[1-9]\\d{6,14}$"}},"additionalProperties":false},"timezone":{"type":"string"},"status":{"type":"string"},"kind":{"type":"string"},"availability_epoch":{"type":"integer"},"max_per_day":{"type":["integer","null"]},"max_per_week":{"type":["integer","null"]}},"required":["id","external_ref","display_label","timezone","status","kind","availability_epoch","max_per_day","max_per_week"],"additionalProperties":false},"tenant_id":{"type":"string","format":"uuid"},"connections":{"type":"array","items":{"type":"object","properties":{"provider":{"type":"string"},"status":{"type":"string"},"account_email":{"type":["string","null"]}},"required":["provider","status","account_email"],"additionalProperties":false}},"capabilities":{"type":"array","items":{"type":"string"}}},"required":["host","tenant_id","connections","capabilities"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"428":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/me \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/me', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/me\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/me', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]},"patch":{"operationId":"patchV1Me","summary":"Change the professional's own settings","tags":["console"],"description":"Timezone and the volume caps change every answer the availability engine gives, so the database bumps the availability epoch itself on this write rather than trusting this endpoint to remember — the invalidation that depends on the caller remembering is the invalidation that eventually does not happen. If-Match is required (428 when it is missing, 412 when it is stale) and is checked against the content ETag from GET /v1/me, not against availability_epoch. status \"paused\" stops new bookability and cancels nothing: sessions already booked stay confirmed and are still honoured; the public booking page stops offering this host, which is the same decision keep makes for a narrowed week — a professional who pauses does not silently lose patients she already accepted. \"archived\" is not set here.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"display_label":{"type":"string","minLength":1,"maxLength":200},"public_profile":{"type":"object","properties":{"show_logo":{"type":"boolean"},"professional_name":{"type":["string","null"],"minLength":1,"maxLength":200,"pattern":"^[^<>\\p{Cc}]+$"},"email_message":{"type":["string","null"],"maxLength":1000,"pattern":"^[^<>\\u0000-\\u0008\\u000B\\u000C\\u000E-\\u001F\\u007F\\u202A-\\u202E\\u2066-\\u2069]*$"},"calendar_name":{"type":["string","null"],"minLength":1,"maxLength":200,"pattern":"^[^<>\\p{Cc}]+$"},"registration":{"type":["string","null"],"minLength":1,"maxLength":80,"pattern":"^[^<>\\p{Cc}]+$"},"profession":{"type":["string","null"],"minLength":1,"maxLength":120,"pattern":"^[^<>\\p{Cc}]+$"},"photo_url":{"type":["string","null"],"maxLength":2048,"format":"uri"},"email":{"type":["string","null"],"maxLength":254,"format":"email"},"phone":{"type":["string","null"],"pattern":"^\\+[1-9]\\d{6,14}$"}},"additionalProperties":false},"timezone":{"type":"string","description":"IANA timezone identifier"},"max_per_day":{"type":["integer","null"],"minimum":1},"max_per_week":{"type":["integer","null"],"minimum":1},"status":{"type":"string","enum":["active","paused"],"description":"paused stops new bookability and cancels nothing. Booked sessions stay confirmed. Only a host that is active is offered on the public booking page."}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"host_id","required":false,"description":"Which host an API credential is acting on. Ignored by a console session, which is pinned to one host by its token, and refused with 403 if it names a different one. Optional when the professional's tenant has exactly one host, which is the normal case."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."},{"schema":{"type":"string"},"in":"header","name":"if-match","required":false,"description":"Required. Weak ETag from the corresponding GET, W/\"<truncated sha256 of the canonical resource>\". Missing is 428 Precondition Required; a mismatch is 412. Derived from the configuration content, never from availability_epoch."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"external_ref":{"type":["string","null"]},"display_label":{"type":"string"},"public_profile":{"type":"object","properties":{"show_logo":{"type":"boolean"},"professional_name":{"type":["string","null"],"minLength":1,"maxLength":200,"pattern":"^[^<>\\p{Cc}]+$"},"email_message":{"type":["string","null"],"maxLength":1000,"pattern":"^[^<>\\u0000-\\u0008\\u000B\\u000C\\u000E-\\u001F\\u007F\\u202A-\\u202E\\u2066-\\u2069]*$"},"calendar_name":{"type":["string","null"],"minLength":1,"maxLength":200,"pattern":"^[^<>\\p{Cc}]+$"},"registration":{"type":["string","null"],"minLength":1,"maxLength":80,"pattern":"^[^<>\\p{Cc}]+$"},"profession":{"type":["string","null"],"minLength":1,"maxLength":120,"pattern":"^[^<>\\p{Cc}]+$"},"photo_url":{"type":["string","null"],"maxLength":2048,"format":"uri"},"email":{"type":["string","null"],"maxLength":254,"format":"email"},"phone":{"type":["string","null"],"pattern":"^\\+[1-9]\\d{6,14}$"}},"additionalProperties":false},"timezone":{"type":"string"},"status":{"type":"string"},"kind":{"type":"string"},"availability_epoch":{"type":"integer"},"max_per_day":{"type":["integer","null"]},"max_per_week":{"type":["integer","null"]}},"required":["id","external_ref","display_label","timezone","status","kind","availability_epoch","max_per_day","max_per_week"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"428":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/me \\\n  --request PATCH \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/me', {\n  method: 'PATCH',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"PATCH\",\n    \"/v1/me\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('PATCH', 'https://api.calendar.anam.app/v1/me', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/me/schedule":{"get":{"operationId":"getV1MeSchedule","summary":"The weekly journey","tags":["console"],"description":"A projection of the recurring availability rules, not a table of its own: a second store for working hours would be a second answer to \"when is this professional free\", and the engine already has one. Windows are anchored to a wall clock in an IANA zone, so 09:00 stays 09:00 across a daylight-saving change instead of drifting by an hour for half the year. The ETag hashes the recurring rules that apply to every event type. It does not include availability_epoch, which a booking increments, and it does not include event-type-specific rules, which this route does not write.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"host_id","required":false,"description":"Which host an API credential is acting on. Ignored by a console session, which is pinned to one host by its token, and refused with 403 if it names a different one. Optional when the professional's tenant has exactly one host, which is the normal case."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"timezone":{"type":"string"},"availability_epoch":{"type":"integer"},"weekly":{"type":"array","items":{"type":"object","properties":{"weekday":{"type":"integer"},"blocks":{"type":"array","items":{"type":"object","properties":{"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^(([01]\\d|2[0-3]):[0-5]\\d|24:00)$"}},"required":["start","end"],"additionalProperties":false}}},"required":["weekday","blocks"],"additionalProperties":false}},"event_type_overrides":{"type":"array","items":{"type":"object","properties":{"event_type_id":{"type":"string","format":"uuid"},"slug":{"type":"string"},"name":{"type":"string"},"weekly":{"type":"array","items":{"type":"object","properties":{"weekday":{"type":"integer"},"blocks":{"type":"array","items":{"type":"object","properties":{"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^(([01]\\d|2[0-3]):[0-5]\\d|24:00)$"}},"required":["start","end"],"additionalProperties":false}}},"required":["weekday","blocks"],"additionalProperties":false}}},"required":["event_type_id","slug","name","weekly"],"additionalProperties":false}}},"required":["timezone","availability_epoch","weekly","event_type_overrides"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"428":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/me/schedule \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/me/schedule', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/me/schedule\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/me/schedule', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]},"put":{"operationId":"putV1MeSchedule","summary":"Replace the weekly journey","tags":["console"],"description":"Rewrites only the recurring rules that apply to every event type. Rules attached to one event type survive, and so do exceptions, because a professional editing their Tuesday should not silently lose the holiday they blocked last week. Two blocks that overlap on the same weekday are refused with both blocks named, since \"invalid schedule\" is not something a screen can act on. If-Match is required: missing is 428, stale is 412, and the validator is the content ETag from GET, not availability_epoch, so a booking that arrived after the read does not fail the check. on_conflict says what happens to sessions the new journey no longer covers. reject (default) returns 409 and writes nothing, listing every affected occurrence with its booking code and the instant in UTC and in the host zone. keep writes the journey and leaves those sessions confirmed — the same decision an open-ended series already makes, where the horizon after the anchor is checked only against the ledger so a later narrowing does not silently drop patients already accepted. release writes the journey and cancels exactly the acknowledged set, through POST /v1/bookings/:id/cancel for a single session and DELETE /v1/occurrences/:id?scope=this for one occurrence of a series. A set that is not exactly what preview showed is 409 and nothing is written, because a patient can book in between.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"timezone":{"type":"string","description":"Applied to the host as well, so the journey and the host can never disagree about which clock 09:00 is on."},"weekly":{"type":"array","items":{"type":"object","properties":{"weekday":{"type":"integer","minimum":0,"maximum":6,"description":"Monday = 0 through Sunday = 6, as everywhere else in this service"},"blocks":{"type":"array","items":{"type":"object","properties":{"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^(([01]\\d|2[0-3]):[0-5]\\d|24:00)$"}},"required":["start","end"],"additionalProperties":false},"maxItems":12}},"required":["weekday","blocks"],"additionalProperties":false},"maxItems":7},"on_conflict":{"type":"string","enum":["reject","keep","release"],"default":"reject","description":"What to do with sessions that would fall outside the new journey. reject (the default) refuses and lists them; keep applies and leaves existing sessions confirmed; release applies and cancels exactly the acknowledged set."},"acknowledged_occurrence_ids":{"type":"array","items":{"type":"string","format":"uuid"},"description":"Required when on_conflict is release. Must equal the affected set, no more and no less. Any divergence is 409 and the journey is left as it was."}},"required":["weekly"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"host_id","required":false,"description":"Which host an API credential is acting on. Ignored by a console session, which is pinned to one host by its token, and refused with 403 if it names a different one. Optional when the professional's tenant has exactly one host, which is the normal case."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."},{"schema":{"type":"string"},"in":"header","name":"if-match","required":false,"description":"Required. Weak ETag from the corresponding GET, W/\"<truncated sha256 of the canonical resource>\". Missing is 428 Precondition Required; a mismatch is 412. Derived from the configuration content, never from availability_epoch."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"timezone":{"type":"string"},"availability_epoch":{"type":"integer"},"weekly":{"type":"array","items":{"type":"object","properties":{"weekday":{"type":"integer"},"blocks":{"type":"array","items":{"type":"object","properties":{"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^(([01]\\d|2[0-3]):[0-5]\\d|24:00)$"}},"required":["start","end"],"additionalProperties":false}}},"required":["weekday","blocks"],"additionalProperties":false}},"event_type_overrides":{"type":"array","items":{"type":"object","properties":{"event_type_id":{"type":"string","format":"uuid"},"slug":{"type":"string"},"name":{"type":"string"},"weekly":{"type":"array","items":{"type":"object","properties":{"weekday":{"type":"integer"},"blocks":{"type":"array","items":{"type":"object","properties":{"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^(([01]\\d|2[0-3]):[0-5]\\d|24:00)$"}},"required":["start","end"],"additionalProperties":false}}},"required":["weekday","blocks"],"additionalProperties":false}}},"required":["event_type_id","slug","name","weekly"],"additionalProperties":false}}},"required":["timezone","availability_epoch","weekly","event_type_overrides"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"428":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/me/schedule \\\n  --request PUT \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/me/schedule', {\n  method: 'PUT',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"PUT\",\n    \"/v1/me/schedule\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('PUT', 'https://api.calendar.anam.app/v1/me/schedule', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/me/schedule/preview":{"post":{"operationId":"postV1MeSchedulePreview","summary":"Preview which sessions a new weekly journey would invalidate","tags":["console"],"description":"Dry run of PUT /v1/me/schedule. Returns the sessions that would fall outside the proposed journey and writes nothing, so the screen can show them before the professional decides to reject, keep, or release. Between this response and the PUT a patient can still book; release therefore requires the ids returned here, and any divergence is a 409 rather than a cancellation of a session she was never shown. The etag is the one PUT requires as If-Match. A booking does not change it.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"timezone":{"type":"string","description":"IANA timezone identifier"},"weekly":{"type":"array","items":{"type":"object","properties":{"weekday":{"type":"integer","minimum":0,"maximum":6,"description":"Monday = 0 through Sunday = 6, as everywhere else in this service"},"blocks":{"type":"array","items":{"type":"object","properties":{"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^(([01]\\d|2[0-3]):[0-5]\\d|24:00)$"}},"required":["start","end"],"additionalProperties":false},"maxItems":12}},"required":["weekday","blocks"],"additionalProperties":false},"maxItems":7}},"required":["weekly"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"host_id","required":false,"description":"Which host an API credential is acting on. Ignored by a console session, which is pinned to one host by its token, and refused with 403 if it names a different one. Optional when the professional's tenant has exactly one host, which is the normal case."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"etag":{"type":"string"},"affected":{"type":"array","items":{"type":"object","properties":{"occurrence_id":{"type":"string","format":"uuid"},"booking_id":{"type":"string","format":"uuid"},"booking_code":{"type":"string"},"starts_at":{"type":"string"},"ends_at":{"type":"string"},"starts_local":{"type":"string"},"ends_local":{"type":"string"},"host_timezone":{"type":"string"},"status":{"type":"string"}},"required":["occurrence_id","booking_id","booking_code","starts_at","ends_at","starts_local","ends_local","host_timezone","status"],"additionalProperties":false}}},"required":["etag","affected"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"428":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/me/schedule/preview \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/me/schedule/preview', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/me/schedule/preview\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/me/schedule/preview', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/me/exceptions":{"get":{"operationId":"getV1MeExceptions","summary":"Overrides and blackouts in a date range","tags":["console"],"description":"The two things that change one day rather than every week: an override that replaces the weekly rule for a date, and a blackout that removes an absolute span. Ordered by the date they affect, because that is the order a screen shows them in.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"host_id","required":false,"description":"Which host an API credential is acting on. Ignored by a console session, which is pinned to one host by its token, and refused with 403 if it names a different one. Optional when the professional's tenant has exactly one host, which is the normal case."},{"schema":{"type":"string","format":"date"},"in":"query","name":"from","required":false},{"schema":{"type":"string","format":"date"},"in":"query","name":"to","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"timezone":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["override","blackout"]},"event_type_id":{"type":["string","null"],"format":"uuid"},"date":{"type":["string","null"]},"start":{"type":["string","null"]},"end":{"type":["string","null"]},"timezone":{"type":["string","null"]},"starts_at":{"type":["string","null"]},"ends_at":{"type":["string","null"]},"starts_local":{"type":["string","null"]},"ends_local":{"type":["string","null"]},"reason":{"type":["string","null"]}},"required":["id","kind","event_type_id","date","start","end","timezone","starts_at","ends_at","starts_local","ends_local","reason"],"additionalProperties":false}}},"required":["timezone","data"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"428":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/me/exceptions \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/me/exceptions', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/me/exceptions\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/me/exceptions', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]},"post":{"operationId":"postV1MeExceptions","summary":"Add one exception","tags":["console"],"description":"One exception at a time, because the alternative is what this surface replaces: blocking a Tuesday afternoon by resending the entire rule set, which loses whatever the other open tab just saved. A blackout that crosses a confirmed session is refused with the sessions listed, each in the host's zone and in UTC, so the screen can say which two appointments to move rather than the word \"conflict\".","requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"kind":{"type":"string","enum":["override"]},"date":{"type":"string","format":"date"},"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$"},"end":{"type":"string","pattern":"^(([01]\\d|2[0-3]):[0-5]\\d|24:00)$"},"event_type_id":{"type":["string","null"],"format":"uuid"},"timezone":{"type":"string","description":"IANA timezone identifier"},"reason":{"type":["string","null"],"maxLength":280}},"required":["kind","date","start","end"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","enum":["blackout"]},"starts_at":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"ends_at":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"event_type_id":{"type":["string","null"],"format":"uuid"},"reason":{"type":["string","null"],"maxLength":280}},"required":["kind","starts_at","ends_at"],"additionalProperties":false}]}}}},"parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"host_id","required":false,"description":"Which host an API credential is acting on. Ignored by a console session, which is pinned to one host by its token, and refused with 403 if it names a different one. Optional when the professional's tenant has exactly one host, which is the normal case."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"kind":{"type":"string","enum":["override","blackout"]},"event_type_id":{"type":["string","null"],"format":"uuid"},"date":{"type":["string","null"]},"start":{"type":["string","null"]},"end":{"type":["string","null"]},"timezone":{"type":["string","null"]},"starts_at":{"type":["string","null"]},"ends_at":{"type":["string","null"]},"starts_local":{"type":["string","null"]},"ends_local":{"type":["string","null"]},"reason":{"type":["string","null"]}},"required":["id","kind","event_type_id","date","start","end","timezone","starts_at","ends_at","starts_local","ends_local","reason"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"428":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/me/exceptions \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/me/exceptions', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/me/exceptions\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/me/exceptions', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/me/exceptions/{id}":{"delete":{"operationId":"deleteV1MeExceptionsById","summary":"Remove one exception","tags":["console"],"description":"Deleting a blackout releases the occupancy row it was holding, which is what makes the time bookable again; leaving the ledger row behind would hide the slot forever with nothing on screen to explain why.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"host_id","required":false,"description":"Which host an API credential is acting on. Ignored by a console session, which is pinned to one host by its token, and refused with 403 if it names a different one. Optional when the professional's tenant has exactly one host, which is the normal case."},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"204":{"description":"Default Response","content":{"application/json":{"schema":{"enum":["null"]}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"428":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/me/exceptions/00000000-0000-4000-8000-000000000000 \\\n  --request DELETE \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/me/exceptions/00000000-0000-4000-8000-000000000000', {\n  method: 'DELETE',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"DELETE\",\n    \"/v1/me/exceptions/00000000-0000-4000-8000-000000000000\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('DELETE', 'https://api.calendar.anam.app/v1/me/exceptions/00000000-0000-4000-8000-000000000000', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/me/event-types":{"get":{"operationId":"getV1MeEventTypes","summary":"The professional's kinds of appointment","tags":["console"],"description":"Deactivated ones are returned too, carrying `active: false`. They are never deleted, because occurrences already reference them and a session whose kind vanished cannot be rendered.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"host_id","required":false,"description":"Which host an API credential is acting on. Ignored by a console session, which is pinned to one host by its token, and refused with 403 if it names a different one. Optional when the professional's tenant has exactly one host, which is the normal case."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"duration_minutes":{"type":"integer"},"buffer_before_minutes":{"type":"integer"},"buffer_after_minutes":{"type":"integer"},"min_notice_minutes":{"type":"integer"},"cancel_notice_minutes":{"type":"integer"},"reschedule_notice_minutes":{"type":"integer"},"max_horizon_days":{"type":"integer"},"slot_interval_minutes":{"type":"integer"},"capacity":{"type":"integer"},"confirmation_policy":{"type":"string"},"visibility":{"type":"string"},"hold_ttl_seconds":{"type":"integer"},"approval_ttl_seconds":{"type":"integer"},"reminder_offsets":{"type":["array","null"],"items":{"type":"string"}},"location_kind":{"type":"string"},"active":{"type":"boolean"},"etag":{"type":"string"}},"required":["id","host_id","slug","name","description","duration_minutes","buffer_before_minutes","buffer_after_minutes","min_notice_minutes","cancel_notice_minutes","reschedule_notice_minutes","max_horizon_days","slot_interval_minutes","capacity","confirmation_policy","visibility","hold_ttl_seconds","approval_ttl_seconds","reminder_offsets","location_kind","active","etag"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"428":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/me/event-types \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/me/event-types', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/me/event-types\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/me/event-types', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]},"post":{"operationId":"postV1MeEventTypes","summary":"Create a kind of appointment","tags":["console"],"description":"The same model the provisioning surface writes, addressed to the professional's own host instead of to an arbitrary one. Buffers are part of what the occupancy ledger blocks, so they are protected time and not a display hint.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{1,62}$"},"name":{"type":"string","minLength":1,"maxLength":200},"description":{"type":["string","null"],"maxLength":2000},"duration_minutes":{"type":"integer","minimum":1,"maximum":1440},"buffer_before_minutes":{"type":"integer","minimum":0,"maximum":1440,"default":0},"buffer_after_minutes":{"type":"integer","minimum":0,"maximum":1440,"default":0},"min_notice_minutes":{"type":"integer","minimum":0,"maximum":2147483647,"default":0},"cancel_notice_minutes":{"type":"integer","minimum":0,"maximum":525600,"default":0,"description":"Minutes before the start during which the attendee may not cancel. The host is not bound. Zero means until the start."},"reschedule_notice_minutes":{"type":"integer","minimum":0,"maximum":525600,"default":0,"description":"Minutes before the start during which the attendee may not move the occurrence. Measured against the occurrence being moved. The host is not bound."},"max_horizon_days":{"type":"integer","minimum":1,"maximum":730,"default":60},"slot_interval_minutes":{"type":"integer","minimum":1,"maximum":1440,"default":15},"capacity":{"type":"integer","minimum":1,"maximum":500,"default":1},"confirmation_policy":{"type":"string","enum":["auto","approval"],"default":"auto"},"visibility":{"type":"string","enum":["public","internal"],"default":"public"},"hold_ttl_seconds":{"type":"integer","minimum":30,"maximum":86400,"default":600},"approval_ttl_seconds":{"type":"integer","minimum":60,"maximum":2592000,"default":172800},"reminder_offsets":{"type":["array","null"],"items":{"type":"string"}},"location_kind":{"type":"string","maxLength":50,"default":"virtual"}},"required":["slug","name","duration_minutes"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"host_id","required":false,"description":"Which host an API credential is acting on. Ignored by a console session, which is pinned to one host by its token, and refused with 403 if it names a different one. Optional when the professional's tenant has exactly one host, which is the normal case."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"duration_minutes":{"type":"integer"},"buffer_before_minutes":{"type":"integer"},"buffer_after_minutes":{"type":"integer"},"min_notice_minutes":{"type":"integer"},"cancel_notice_minutes":{"type":"integer"},"reschedule_notice_minutes":{"type":"integer"},"max_horizon_days":{"type":"integer"},"slot_interval_minutes":{"type":"integer"},"capacity":{"type":"integer"},"confirmation_policy":{"type":"string"},"visibility":{"type":"string"},"hold_ttl_seconds":{"type":"integer"},"approval_ttl_seconds":{"type":"integer"},"reminder_offsets":{"type":["array","null"],"items":{"type":"string"}},"location_kind":{"type":"string"},"active":{"type":"boolean"}},"required":["id","host_id","slug","name","description","duration_minutes","buffer_before_minutes","buffer_after_minutes","min_notice_minutes","cancel_notice_minutes","reschedule_notice_minutes","max_horizon_days","slot_interval_minutes","capacity","confirmation_policy","visibility","hold_ttl_seconds","approval_ttl_seconds","reminder_offsets","location_kind","active"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"428":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/me/event-types \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/me/event-types', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/me/event-types\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/me/event-types', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/me/event-types/{id}":{"get":{"operationId":"getV1MeEventTypesById","summary":"One kind of appointment","tags":["console"],"description":"The representation PATCH requires an ETag for. The ETag is a hash of this event type, not of availability_epoch, so a booking against it does not change the validator.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"host_id","required":false,"description":"Which host an API credential is acting on. Ignored by a console session, which is pinned to one host by its token, and refused with 403 if it names a different one. Optional when the professional's tenant has exactly one host, which is the normal case."},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"duration_minutes":{"type":"integer"},"buffer_before_minutes":{"type":"integer"},"buffer_after_minutes":{"type":"integer"},"min_notice_minutes":{"type":"integer"},"cancel_notice_minutes":{"type":"integer"},"reschedule_notice_minutes":{"type":"integer"},"max_horizon_days":{"type":"integer"},"slot_interval_minutes":{"type":"integer"},"capacity":{"type":"integer"},"confirmation_policy":{"type":"string"},"visibility":{"type":"string"},"hold_ttl_seconds":{"type":"integer"},"approval_ttl_seconds":{"type":"integer"},"reminder_offsets":{"type":["array","null"],"items":{"type":"string"}},"location_kind":{"type":"string"},"active":{"type":"boolean"}},"required":["id","host_id","slug","name","description","duration_minutes","buffer_before_minutes","buffer_after_minutes","min_notice_minutes","cancel_notice_minutes","reschedule_notice_minutes","max_horizon_days","slot_interval_minutes","capacity","confirmation_policy","visibility","hold_ttl_seconds","approval_ttl_seconds","reminder_offsets","location_kind","active"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"428":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/me/event-types/00000000-0000-4000-8000-000000000000 \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/me/event-types/00000000-0000-4000-8000-000000000000', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/me/event-types/00000000-0000-4000-8000-000000000000\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/me/event-types/00000000-0000-4000-8000-000000000000', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]},"patch":{"operationId":"patchV1MeEventTypesById","summary":"Change a kind of appointment","tags":["console"],"description":"Changing the duration or a buffer does not move appointments that are already confirmed, and the response says how many future ones still carry the old policy. Staying silent about that is the expensive failure here: the professional believes their Thursday is now 40-minute sessions, the ledger still holds 50-minute blocks, and nobody finds out until two patients arrive at once. If-Match is required and carries the ETag from GET /v1/me/event-types/:id. Missing is 428; a mismatch is 412.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200},"description":{"type":["string","null"],"maxLength":2000},"duration_minutes":{"type":"integer","minimum":1,"maximum":1440},"buffer_before_minutes":{"type":"integer","minimum":0,"maximum":1440},"buffer_after_minutes":{"type":"integer","minimum":0,"maximum":1440},"min_notice_minutes":{"type":"integer","minimum":0,"maximum":2147483647},"cancel_notice_minutes":{"type":"integer","minimum":0,"maximum":525600},"reschedule_notice_minutes":{"type":"integer","minimum":0,"maximum":525600},"max_horizon_days":{"type":"integer","minimum":1,"maximum":730},"slot_interval_minutes":{"type":"integer","minimum":1,"maximum":1440},"capacity":{"type":"integer","minimum":1,"maximum":500},"confirmation_policy":{"type":"string","enum":["auto","approval"]},"visibility":{"type":"string","enum":["public","internal"]},"hold_ttl_seconds":{"type":"integer","minimum":30,"maximum":86400},"approval_ttl_seconds":{"type":"integer","minimum":60,"maximum":2592000},"reminder_offsets":{"type":["array","null"],"items":{"type":"string"}},"location_kind":{"type":"string","maxLength":50},"active":{"type":"boolean"}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"host_id","required":false,"description":"Which host an API credential is acting on. Ignored by a console session, which is pinned to one host by its token, and refused with 403 if it names a different one. Optional when the professional's tenant has exactly one host, which is the normal case."},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."},{"schema":{"type":"string"},"in":"header","name":"if-match","required":false,"description":"Required. Weak ETag from the corresponding GET, W/\"<truncated sha256 of the canonical resource>\". Missing is 428 Precondition Required; a mismatch is 412. Derived from the configuration content, never from availability_epoch."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"event_type":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"duration_minutes":{"type":"integer"},"buffer_before_minutes":{"type":"integer"},"buffer_after_minutes":{"type":"integer"},"min_notice_minutes":{"type":"integer"},"cancel_notice_minutes":{"type":"integer"},"reschedule_notice_minutes":{"type":"integer"},"max_horizon_days":{"type":"integer"},"slot_interval_minutes":{"type":"integer"},"capacity":{"type":"integer"},"confirmation_policy":{"type":"string"},"visibility":{"type":"string"},"hold_ttl_seconds":{"type":"integer"},"approval_ttl_seconds":{"type":"integer"},"reminder_offsets":{"type":["array","null"],"items":{"type":"string"}},"location_kind":{"type":"string"},"active":{"type":"boolean"}},"required":["id","host_id","slug","name","description","duration_minutes","buffer_before_minutes","buffer_after_minutes","min_notice_minutes","cancel_notice_minutes","reschedule_notice_minutes","max_horizon_days","slot_interval_minutes","capacity","confirmation_policy","visibility","hold_ttl_seconds","approval_ttl_seconds","reminder_offsets","location_kind","active"],"additionalProperties":false},"retroactive":{"type":"object","properties":{"applies_to_future_bookings_only":{"type":"boolean","enum":[true]},"changed_fields":{"type":"array","items":{"type":"string"}},"previous":{"type":"object","properties":{"duration_minutes":{"type":"integer"},"buffer_before_minutes":{"type":"integer"},"buffer_after_minutes":{"type":"integer"}},"required":["duration_minutes","buffer_before_minutes","buffer_after_minutes"],"additionalProperties":false},"future_occurrences_with_previous_duration":{"type":"integer"},"future_occurrences_with_previous_buffers":{"type":"integer"},"earliest_at":{"type":["string","null"]},"latest_at":{"type":["string","null"]}},"required":["applies_to_future_bookings_only","changed_fields","previous","future_occurrences_with_previous_duration","future_occurrences_with_previous_buffers","earliest_at","latest_at"],"additionalProperties":false}},"required":["event_type","retroactive"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"428":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/me/event-types/00000000-0000-4000-8000-000000000000 \\\n  --request PATCH \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/me/event-types/00000000-0000-4000-8000-000000000000', {\n  method: 'PATCH',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"PATCH\",\n    \"/v1/me/event-types/00000000-0000-4000-8000-000000000000\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('PATCH', 'https://api.calendar.anam.app/v1/me/event-types/00000000-0000-4000-8000-000000000000', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]},"delete":{"operationId":"deleteV1MeEventTypesById","summary":"Deactivate a kind of appointment","tags":["console"],"description":"Deactivates; never deletes. Occurrences reference the event type, so removing the row would take a confirmed session's meaning with it. Appointments already booked stay booked, and the response says how many.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"host_id","required":false,"description":"Which host an API credential is acting on. Ignored by a console session, which is pinned to one host by its token, and refused with 403 if it names a different one. Optional when the professional's tenant has exactly one host, which is the normal case."},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"event_type":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"duration_minutes":{"type":"integer"},"buffer_before_minutes":{"type":"integer"},"buffer_after_minutes":{"type":"integer"},"min_notice_minutes":{"type":"integer"},"cancel_notice_minutes":{"type":"integer"},"reschedule_notice_minutes":{"type":"integer"},"max_horizon_days":{"type":"integer"},"slot_interval_minutes":{"type":"integer"},"capacity":{"type":"integer"},"confirmation_policy":{"type":"string"},"visibility":{"type":"string"},"hold_ttl_seconds":{"type":"integer"},"approval_ttl_seconds":{"type":"integer"},"reminder_offsets":{"type":["array","null"],"items":{"type":"string"}},"location_kind":{"type":"string"},"active":{"type":"boolean"}},"required":["id","host_id","slug","name","description","duration_minutes","buffer_before_minutes","buffer_after_minutes","min_notice_minutes","cancel_notice_minutes","reschedule_notice_minutes","max_horizon_days","slot_interval_minutes","capacity","confirmation_policy","visibility","hold_ttl_seconds","approval_ttl_seconds","reminder_offsets","location_kind","active"],"additionalProperties":false},"future_occurrences_kept":{"type":"integer"}},"required":["event_type","future_occurrences_kept"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"428":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/me/event-types/00000000-0000-4000-8000-000000000000 \\\n  --request DELETE \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/me/event-types/00000000-0000-4000-8000-000000000000', {\n  method: 'DELETE',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"DELETE\",\n    \"/v1/me/event-types/00000000-0000-4000-8000-000000000000\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('DELETE', 'https://api.calendar.anam.app/v1/me/event-types/00000000-0000-4000-8000-000000000000', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/me/calendar":{"get":{"operationId":"getV1MeCalendar","summary":"The professional's own calendar","tags":["console"],"description":"Carries no patient identity, and cannot be made to. This service stores no name, e-mail or telephone number for an attendee, which is the property the whole data-protection position rests on, so each appointment is identified by its booking code and by the opaque references the integrator resolves against its own records. Embedded in the integrator's application the names appear and never pass through this server; standalone, the code appears and the screen still works.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"host_id","required":false,"description":"Which host an API credential is acting on. Ignored by a console session, which is pinned to one host by its token, and refused with 403 if it names a different one. Optional when the professional's tenant has exactly one host, which is the normal case."},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"from","required":false,"description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"to","required":false,"description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},{"schema":{"type":"string"},"in":"query","name":"status","required":false,"description":"Comma-separated booking statuses. Defaults to pending_approval and confirmed, which is what a host calendar means."},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"use_display_preferences","required":false,"description":"Apply the host’s inherited display preferences when status is omitted."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"booking_id","required":false,"description":"Restrict the projection to one booking, preserving the exact tenant, host and event-type authority. Useful for bounded reconciliation of a finite series."},{"schema":{"type":"integer","minimum":1,"maximum":500,"default":200},"in":"query","name":"limit","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"timezone":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"occurrence_id":{"type":"string","format":"uuid"},"booking_id":{"type":"string","format":"uuid"},"booking_sequence":{"type":"integer","minimum":0},"title":{"type":["string","null"],"maxLength":160},"availability":{"type":"string","enum":["busy","free"]},"duration_minutes":{"type":["integer","null"]},"booking_code":{"type":"string"},"event_type":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"slug":{"type":"string"},"name":{"type":"string"},"duration_minutes":{"type":"integer"}},"required":["id","slug","name","duration_minutes"],"additionalProperties":false},"starts_at":{"type":"string"},"ends_at":{"type":"string"},"starts_local":{"type":"string"},"ends_local":{"type":"string"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"rescheduled_away":{"type":"boolean"},"revision":{"type":"integer"},"attendee_refs":{"type":"array","items":{"type":"string"}},"location_kind":{"type":"string"},"external_sync":{"type":["object","null"],"properties":{"provider":{"type":"string"},"state":{"type":"string"},"revision_pushed":{"type":["integer","null"]},"current_revision":{"type":"boolean","description":"The latest desired projection has a completed durable operation receipt and, while live, a synced link with matching non-null desired/observed hashes for the target calendar. Known drift withdraws confirmation. Internal-only revisions require no external write; this reflects the last durable receipt/observation, not an instantaneous provider read."},"desired_revision":{"type":["integer","null"]},"operation_state":{"type":["string","null"],"enum":["pending","running","failed","completed","dead"]},"completed_at":{"type":["string","null"]}},"required":["provider","state","revision_pushed","current_revision","desired_revision","operation_state","completed_at"],"additionalProperties":false},"external_syncs":{"type":"array","items":{"type":"object","properties":{"provider":{"type":"string"},"state":{"type":"string"},"revision_pushed":{"type":["integer","null"]},"current_revision":{"type":"boolean","description":"The latest desired projection has a completed durable operation receipt and, while live, a synced link with matching non-null desired/observed hashes for the target calendar. Known drift withdraws confirmation. Internal-only revisions require no external write; this reflects the last durable receipt/observation, not an instantaneous provider read."},"desired_revision":{"type":["integer","null"]},"operation_state":{"type":["string","null"],"enum":["pending","running","failed","completed","dead"]},"completed_at":{"type":["string","null"]}},"required":["provider","state","revision_pushed","current_revision","desired_revision","operation_state","completed_at"],"additionalProperties":false},"maxItems":3,"description":"Every configured provider for this occurrence, including pending and unavailable targets. An empty list means no provider projection is configured."}},"required":["occurrence_id","booking_id","booking_sequence","title","availability","duration_minutes","booking_code","event_type","starts_at","ends_at","starts_local","ends_local","status","revision","attendee_refs","location_kind","external_sync","external_syncs"],"additionalProperties":false}}},"required":["timezone","data"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"428":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/me/calendar \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/me/calendar', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/me/calendar\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/me/calendar', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/me/conflicts":{"get":{"operationId":"getV1MeConflicts","summary":"Everything wrong with this calendar right now","tags":["console"],"description":"The one screen only this service can build: nobody else sees a personal commitment sitting on top of a confirmed session, a connection whose token needs reauthorising, a mirror write that failed, a host-deleted mirror waiting for restore, or a day that went past the professional's own limit. Read plus acknowledge, nothing more — the corrective actions are the existing cancellation, reschedule and mirror-restore endpoints, named in `suggested_action` and called by the console unchanged, because a second path into the booking rules is a second place for them to drift.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"host_id","required":false,"description":"Which host an API credential is acting on. Ignored by a console session, which is pinned to one host by its token, and refused with 403 if it names a different one. Optional when the professional's tenant has exactly one host, which is the normal case."},{"schema":{"type":"string","enum":["true","false"],"default":"false"},"in":"query","name":"include_acknowledged","required":false,"description":"Acknowledged conflicts are hidden by default; a conflict reappears on its own if the facts behind it change."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["external_busy_overlap","drift_repaired","connection_reauth_required","mirror_failed","mirror_omitted","approval_expiring","overbooked_day"]},"severity":{"type":"string","enum":["info","warning","critical"]},"detected_at":{"type":"string"},"subject":{"type":"object","additionalProperties":{}},"detail":{"type":"object","additionalProperties":{}},"suggested_action":{"type":"string"},"actions":{"type":"array","items":{"type":"object","properties":{"method":{"type":"string"},"path":{"type":"string"},"label":{"type":"string"}},"required":["method","path","label"],"additionalProperties":false}},"acknowledged_at":{"type":["string","null"]}},"required":["id","kind","severity","detected_at","subject","detail","suggested_action","actions","acknowledged_at"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"428":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/me/conflicts \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/me/conflicts', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/me/conflicts\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/me/conflicts', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/me/conflicts/{id}/acknowledge":{"post":{"operationId":"postV1MeConflictsByIdAcknowledge","summary":"Acknowledge a conflict","tags":["console"],"description":"Records that a person saw this and chose to leave it. The identifier is derived from the rows the conflict was detected over, so an acknowledgement stops applying the moment those rows change — a busy block that moved is a new conflict, not an old one still dismissed.","requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"not":{}},{"type":"object","properties":{"note":{"type":["string","null"],"maxLength":500}},"additionalProperties":false}]}}}},"parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"host_id","required":false,"description":"Which host an API credential is acting on. Ignored by a console session, which is pinned to one host by its token, and refused with 403 if it names a different one. Optional when the professional's tenant has exactly one host, which is the normal case."},{"schema":{"type":"string","minLength":8,"maxLength":64},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string","enum":["external_busy_overlap","drift_repaired","connection_reauth_required","mirror_failed","mirror_omitted","approval_expiring","overbooked_day"]},"acknowledged_at":{"type":"string"},"acknowledged_by":{"type":"string"},"note":{"type":["string","null"]}},"required":["id","kind","acknowledged_at","acknowledged_by","note"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"428":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/me/conflicts/00000000-0000-4000-8000-000000000000/acknowledge \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/me/conflicts/00000000-0000-4000-8000-000000000000/acknowledge', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/me/conflicts/00000000-0000-4000-8000-000000000000/acknowledge\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/me/conflicts/00000000-0000-4000-8000-000000000000/acknowledge', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/me/events":{"get":{"summary":"Stream host-scoped committed scheduling notices","tags":["console"],"description":"Bearer header only. Last-Event-ID resumes a bounded metadata feed; reset requires an API snapshot. Events never certify provider confirmation. Slow readers disconnect. Already issued credentials are rechecked during streaming.","parameters":[{"schema":{"type":"string","maxLength":512},"in":"query","name":"cursor","required":false}],"responses":{"200":{"description":"SSE frames: calendar.changed, reset, and heartbeat comments. calendar.changed data follows v1/events/notification.schema.json.","content":{"text/event-stream":{"schema":{"type":"string"}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"operationId":"getV1MeEvents","x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/me/events \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/me/events', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/me/events\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/me/events', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/occurrences/{id}/notification-dispatch":{"get":{"operationId":"getV1OccurrencesByIdNotificationDispatch","summary":"Read notification command acceptance counts for an exact occurrence","tags":["bookings"],"description":"Backend credentials only. Tenant and optional host/event-type scope apply. Constant-size projection of outbox command states, without payload, contact data or provider errors. Accepted means Notifications accepted the command, not that a person received a message.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"counts":{"type":"object","properties":{"queued":{"type":"integer","minimum":0},"retrying":{"type":"integer","minimum":0},"accepted":{"type":"integer","minimum":0},"failed":{"type":"integer","minimum":0},"cancelled":{"type":"integer","minimum":0}},"required":["queued","retrying","accepted","failed","cancelled"],"additionalProperties":false}},"required":["counts"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000/notification-dispatch \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000/notification-dispatch', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/occurrences/00000000-0000-4000-8000-000000000000/notification-dispatch\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000/notification-dispatch', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/me/calendar-feed":{"post":{"operationId":"postV1MeCalendarFeed","summary":"Mint a signed feed of this host's sessions","tags":["console"],"description":"The URL is the credential. It is returned once and stored only as a hash. The feed lists sessions and no patient. It does not read a personal calendar, so it cannot prevent collisions with commitments that exist only there. Minting again revokes the previous URL.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"webcal_url":{"type":"string"},"created_at":{"type":"string","format":"date-time"}},"required":["url","webcal_url","created_at"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/me/calendar-feed \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/me/calendar-feed', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/me/calendar-feed\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/me/calendar-feed', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]},"get":{"operationId":"getV1MeCalendarFeed","summary":"Whether this host has a live feed","tags":["console"],"description":"Does not return the URL. A feed that can be read back after minting is a feed whose secret was stored.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"active":{"type":"boolean"},"created_at":{"type":["string","null"],"format":"date-time"}},"required":["active","created_at"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/me/calendar-feed \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/me/calendar-feed', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/me/calendar-feed\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/me/calendar-feed', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]},"delete":{"operationId":"deleteV1MeCalendarFeed","summary":"Revoke the signed feed","tags":["console"],"description":"The URL stops working on the next fetch. Revoking a feed that is already dead is success.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"204":{"description":"Default Response","content":{"application/json":{"schema":{"enum":["null"]}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/me/calendar-feed \\\n  --request DELETE \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/me/calendar-feed', {\n  method: 'DELETE',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"DELETE\",\n    \"/v1/me/calendar-feed\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('DELETE', 'https://api.calendar.anam.app/v1/me/calendar-feed', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/feeds/{token}":{"get":{"operationId":"getV1FeedsByToken","summary":"The signed session feed","tags":["console"],"description":"Unauthenticated because the token in the path is the credential. The body is an iCalendar document of this host's sessions. It carries no patient. A missing or revoked token is a 404.","parameters":[{"schema":{"type":"string","minLength":8,"maxLength":200},"in":"path","name":"token","required":true}],"responses":{"200":{"description":"Default Response"}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/feeds/example \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/feeds/example', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/feeds/example\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/feeds/example', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/event-types/{id}/series/extend":{"post":{"operationId":"postV1EventTypesByIdSeriesExtend","summary":"Extend accepted series into their next calendar window","tags":["bookings"],"description":"Materializes a bounded batch adjacent to the existing horizon. Retry while has_more is true. Only existing confirmed commitments are extended.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"from":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"to":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"}},"required":["from","to"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"has_more":{"type":"boolean"}},"required":["has_more"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/event-types/00000000-0000-4000-8000-000000000000/series/extend \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/event-types/00000000-0000-4000-8000-000000000000/series/extend', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/event-types/00000000-0000-4000-8000-000000000000/series/extend\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/event-types/00000000-0000-4000-8000-000000000000/series/extend', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/bookings/{bookingId}/occurrences/{id}/conference":{"post":{"operationId":"postV1BookingsByBookingidOccurrencesByIdConference","summary":"Request Google Meet for one existing occurrence","tags":["bookings"],"description":"Request Google Meet for one existing occurrence","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expected_revision":{"type":"integer","minimum":0}},"required":["expected_revision"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"bookingId","required":true},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":true}],"responses":{"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"conference_state":{"type":"string","enum":["pending","ready"]}},"required":["conference_state"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/occurrences/00000000-0000-4000-8000-000000000000/conference \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/occurrences/00000000-0000-4000-8000-000000000000/conference', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/bookings/00000000-0000-4000-8000-000000000000/occurrences/00000000-0000-4000-8000-000000000000/conference\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/occurrences/00000000-0000-4000-8000-000000000000/conference', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/availability/slots":{"get":{"operationId":"getV1AvailabilitySlots","summary":"List bookable slots","tags":["availability"],"description":"Returns absolute instants together with the host and viewer wall clocks. The viewer timezone defaults to the host timezone when omitted.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"event_type_id","required":true},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"from","required":true,"description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"to","required":true,"description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},{"schema":{"type":"string"},"in":"query","name":"timezone","required":false,"description":"IANA timezone identifier"},{"schema":{"type":"integer","minimum":1,"maximum":5000,"default":2000},"in":"query","name":"limit","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"event_type_id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"host_timezone":{"type":"string"},"viewer_timezone":{"type":"string"},"duration_minutes":{"type":"integer"},"slots":{"type":"array","items":{"type":"object","properties":{"starts_at":{"type":"string"},"ends_at":{"type":"string"},"host_local":{"type":"string"},"viewer_local":{"type":"string"},"remaining":{"type":"integer"},"different_local_day":{"type":"boolean"},"dst_note":{"type":["string","null"]}},"required":["starts_at","ends_at","host_local","viewer_local","remaining","different_local_day","dst_note"],"additionalProperties":false}},"computed_at":{"type":"string"},"cache_ttl_seconds":{"type":"integer"},"cache":{"type":"string","enum":["hit","miss"]}},"required":["event_type_id","host_id","host_timezone","viewer_timezone","duration_minutes","slots","computed_at","cache_ttl_seconds","cache"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/availability/slots \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/availability/slots', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/availability/slots\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/availability/slots', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/attendees/rekey":{"post":{"operationId":"postV1AttendeesRekey","summary":"Replace a participant ref that was stored as a source id","tags":["bookings"],"description":"The tenant supplies the source id and the opaque ref it minted. Operational attendee, hold, waitlist and queued-command references are replaced. Audit/access history and frozen idempotent response DTOs remain unchanged. An append-only alias lets access-history queries resolve either reference and new notices use the current reference. The call does not return the pair. Safe to retry. Does not change booking.external_ref, and refuses an approval-hold ref.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"from":{"type":"string","minLength":1,"maxLength":255,"description":"Source-system id already stored as a participant ref. Kept on the access trail, and recorded once as the start of an append-only equivalence."},"to":{"type":"string","minLength":1,"maxLength":255,"description":"Opaque participant id that replaces the source id on operational rows. The call does not return the pair. A query for either ref follows the chain."}},"required":["from","to"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"attendees":{"type":"integer"},"holds":{"type":"integer"},"access_records":{"type":"integer","description":"Always 0. The access trail is append-only and is not rewritten."},"subject_links":{"type":"integer","description":"Equivalence rows inserted. 0 when this pair was already linked."},"waitlist_entries":{"type":"integer"},"session_packages":{"type":"integer","description":"Balances whose participant ref was rewritten."},"outbox_events":{"type":"integer"},"messenger_deliveries":{"type":"integer"},"idempotent_responses":{"type":"integer"},"audit_entries":{"type":"integer"}},"required":["attendees","holds","access_records","subject_links","waitlist_entries","session_packages","outbox_events","messenger_deliveries","idempotent_responses","audit_entries"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/attendees/rekey \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/attendees/rekey', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/attendees/rekey\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/attendees/rekey', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/holds":{"post":{"operationId":"postV1Holds","summary":"Hold a slot while the caller completes a booking","tags":["holds"],"description":"Hold a slot while the caller completes a booking","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"event_type_id":{"type":"string","format":"uuid"},"starts_at":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"attendee_ref":{"type":["string","null"],"maxLength":255,"description":"Opaque participant id. Not a source-system patient id."},"attendee_timezone":{"type":["string","null"],"description":"IANA timezone identifier"}},"required":["event_type_id","starts_at"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"token":{"type":"string"},"expires_at":{"type":"string"},"starts_at":{"type":"string"},"ends_at":{"type":"string"}},"required":["id","token","expires_at","starts_at","ends_at"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/holds \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/holds', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/holds\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/holds', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/holds/{id}/renew":{"post":{"operationId":"postV1HoldsByIdRenew","summary":"Extend a hold that is still being filled in","tags":["holds"],"description":"Extend a hold that is still being filled in","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string","minLength":1,"maxLength":1024}},"required":["token"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"expires_at":{"type":"string"}},"required":["id","expires_at"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/holds/00000000-0000-4000-8000-000000000000/renew \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/holds/00000000-0000-4000-8000-000000000000/renew', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/holds/00000000-0000-4000-8000-000000000000/renew\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/holds/00000000-0000-4000-8000-000000000000/renew', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/holds/{id}":{"delete":{"operationId":"deleteV1HoldsById","summary":"Release a hold","tags":["holds"],"description":"Release a hold","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"204":{"description":"Default Response","content":{"application/json":{"schema":{"enum":["null"]}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/holds/00000000-0000-4000-8000-000000000000 \\\n  --request DELETE \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/holds/00000000-0000-4000-8000-000000000000', {\n  method: 'DELETE',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"DELETE\",\n    \"/v1/holds/00000000-0000-4000-8000-000000000000\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('DELETE', 'https://api.calendar.anam.app/v1/holds/00000000-0000-4000-8000-000000000000', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/bookings":{"post":{"operationId":"postV1Bookings","summary":"Create a booking, optionally recurring","tags":["bookings"],"description":"Authenticated booking:write callers may record past events outside the current offering grid; the occupancy ledger and resource authorization still apply. Past dates produce no confirmation or reminder commands. Future dates follow normal availability policy. Public booking capabilities cannot enable retrospective creation. Pass hold_token to convert a valid hold.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"import_mode":{"type":"string","enum":["preserve_overlaps"],"description":"Trusted silent import of an existing independent commitment. Preserves original overlapping host times as busy occupancy; requires config:write. Not available to public booking."},"allow_google_conflict":{"type":"boolean","enum":[true],"description":"Trusted manual creation only. Ignores Google busy intervals while retaining native availability and occupancy checks."},"conference":{"type":"string","enum":["google"]},"confirmation":{"type":"string","enum":["confirmed"]},"communication_plan":{"type":"object","properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"allow_outside_availability":{"type":"boolean","description":"Trusted scheduling override; occupancy and blocks remain enforced."},"event_type_id":{"type":"string","format":"uuid"},"starts_at":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"hold_token":{"type":["string","null"]},"attendees":{"type":"array","items":{"type":"object","properties":{"external_ref":{"type":"string","minLength":1,"maxLength":255,"description":"Opaque participant id minted by the tenant, stable for that person. Not a source-system patient id, e-mail, phone or name — those are correlatable, and this value is copied into bookings, commands and logs. The tenant keeps the mapping. A value already stored in the wrong form is replaced on operational rows by POST /v1/attendees/rekey. The access trail keeps the old ref; one append-only link says the two are the same person, and the call does not return the pair."},"role":{"type":"string","enum":["primary","guest"],"default":"primary"},"timezone":{"type":"string","description":"IANA timezone identifier"},"locale":{"type":["string","null"],"maxLength":35}},"required":["external_ref","timezone"],"additionalProperties":false},"maxItems":50,"description":"May be empty for internal auto-confirm event types; such events do not create participants or notifications."},"title":{"type":["string","null"],"minLength":1,"maxLength":160,"description":"Private display title. Not copied to provider calendars or notifications."},"availability":{"type":"string","enum":["busy","free"],"description":"Busy reserves time in the occupancy ledger; free remains visible without blocking time.","default":"busy"},"duration_minutes":{"type":"integer","minimum":1,"maximum":1440,"description":"Duration override for authenticated scheduling. Public booking uses event-type duration."},"external_ref":{"type":["string","null"],"maxLength":255,"description":"Caller-owned id of this booking, used to route webhooks back to the integrator. Not a participant id and not rewritten by POST /v1/attendees/rekey."},"tenant_metadata":{"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":256},{"type":"number"},{"type":"boolean"},{"enum":["null"]}]},"description":"Flat, bounded opaque routing references. No names, clinical content or credentials. Not authorization."},"event_details":{"type":"object","properties":{"link":{"type":["string","null"],"maxLength":800},"address":{"type":["string","null"],"minLength":1,"maxLength":1024},"description":{"type":["string","null"],"minLength":1,"maxLength":2000,"description":"Scheduling instructions visible in managed external calendars. Never include clinical or confidential notes."}},"additionalProperties":false},"event_metadata":{"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":256},{"type":"number"},{"type":"boolean"},{"enum":["null"]}]},"description":"Initial occurrence metadata inherited by every materialised occurrence of this booking, including later open-ended expansion. Not projected to providers, messenger, inbox or public pages."},"recurrence":{"type":"object","properties":{"rrule":{"type":"string","minLength":3,"description":"RFC 5545 RRULE without DTSTART"},"count":{"type":"integer","minimum":1,"maximum":366,"description":"Omit for an indefinite series. Expansion is bounded by the rolling horizon; COUNT is part of the stored RFC 5545 rule."},"on_conflict":{"type":"string","enum":["fail","skip"],"default":"fail"}},"required":["rrule"],"additionalProperties":false},"package_id":{"type":["string","null"],"format":"uuid","description":"Balance to draw one appointment from for each occurrence created. The participant on the package must be an attendee. An open-ended series cannot draw from a package."}},"required":["event_type_id","starts_at","attendees"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"booking":{"type":"object","properties":{"auto_reschedule":{"type":["object","null"],"properties":{"queue_position":{"type":["integer","null"],"exclusiveMinimum":true,"minimum":0},"id":{"type":"string","format":"uuid"},"occurrence_id":{"type":"string","format":"uuid"},"preferred_start":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"status":{"type":"string","enum":["waiting","applied","withdrawn","expired"]},"result_occurrence_id":{"type":["string","null"],"format":"uuid"}},"required":["queue_position","id","occurrence_id","preferred_start","status","result_occurrence_id"],"additionalProperties":false},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"reschedule_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"deletion_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"event_type_id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"sequence":{"type":"integer"},"title":{"type":["string","null"],"minLength":1,"maxLength":160,"description":"Private display title. Not copied to provider calendars or notifications."},"availability":{"type":"string","enum":["busy","free"],"description":"Busy reserves time in the occupancy ledger; free remains visible without blocking time."},"duration_minutes":{"type":["integer","null"],"minimum":1,"maximum":1440},"external_ref":{"type":["string","null"],"description":"Caller-owned id of this booking. Not a participant id."},"session_package_id":{"type":["string","null"],"format":"uuid","description":"Balance this booking draws from. Null when the booking is not part of a package."},"tenant_metadata":{"type":"object","additionalProperties":{}},"occurrences":{"type":"array","items":{"type":"object","properties":{"recurrence_rule":{"type":"string","maxLength":1024,"description":"Rule for the occurrence’s own series, when read in booking detail."},"attendee_override":{"type":["array","null"],"items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false}},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"event_metadata":{"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":256},{"type":"number"},{"type":"boolean"},{"enum":["null"]}]},"description":"Flat, bounded opaque occurrence references owned by the integrator. No names, clinical content or credentials. Not authorization. Not projected to providers, messenger commands, inbox or public pages."},"event_details":{"type":"object","properties":{"link":{"type":["string","null"],"maxLength":800},"address":{"type":["string","null"],"minLength":1,"maxLength":1024},"description":{"type":["string","null"],"minLength":1,"maxLength":2000,"description":"Scheduling instructions visible in managed external calendars. Never include clinical or confidential notes."}},"additionalProperties":false},"conference_state":{"type":["string","null"],"enum":["pending","ready","failed"]},"root_occurrence_id":{"type":"string","format":"uuid"},"recurrence_order_local":{"type":["string","null"]},"id":{"type":"string","format":"uuid"},"booking_id":{"type":"string","format":"uuid"},"series_id":{"type":["string","null"],"format":"uuid"},"starts_at":{"type":"string"},"ends_at":{"type":"string"},"starts_local":{"type":"string"},"host_timezone":{"type":"string"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"revision":{"type":"integer"},"tz_resolution":{"type":["string","null"],"enum":["exact","shifted_forward","first_of_ambiguous"]},"dst_shift_flag":{"type":"boolean"},"rescheduled_from_id":{"type":["string","null"],"format":"uuid"},"join_url":{"type":["string","null"]},"covering_host_id":{"type":["string","null"],"format":"uuid","description":"Host delivering this occurrence when it is not the booking host. Null means the booking host."},"participant_responses":{"type":"array","items":{"type":"object","properties":{"attendee_ref":{"type":"string"},"response_status":{"type":"string","enum":["accepted","tentative","declined","needs_action"]},"response_source":{"type":"string","enum":["participant","host"]},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"responded_at":{"type":"string"},"occurrence_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["attendee_ref","response_status","version","responded_at","occurrence_revision"],"additionalProperties":false},"maxItems":50,"description":"Response for this exact revision. A host may record it on behalf of the participant or reset it to needs_action. Absence means unknown."}},"required":["id","booking_id","series_id","starts_at","ends_at","starts_local","host_timezone","status","revision","tz_resolution","dst_shift_flag","rescheduled_from_id","join_url","covering_host_id"],"additionalProperties":false},"maxItems":2048,"description":"Complete non-removed occurrence history, up to 2048 rows. Larger aggregates return 422 booking_detail_limit_exceeded without truncation; use the bounded summary and operational reconciliation."},"attendees":{"type":"array","items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false},"maxItems":50},"created_at":{"type":["string","null"]},"updated_at":{"type":["string","null"]}},"required":["id","status","event_type_id","host_id","sequence","external_ref","session_package_id","tenant_metadata","occurrences","attendees","created_at","updated_at"],"additionalProperties":false},"skipped":{"type":"array","items":{"type":"object","properties":{"starts_at":{"type":"string"},"reason":{"type":"string"}},"required":["starts_at","reason"],"additionalProperties":false}},"external_sync":{"type":"object","additionalProperties":{"type":"object","properties":{"state":{"type":"string"}},"required":["state"],"additionalProperties":false}}},"required":["booking","skipped","external_sync"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/bookings \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/bookings', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/bookings\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/bookings', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]},"get":{"operationId":"getV1Bookings","summary":"List bookings","tags":["bookings"],"description":"Scoped to one professional when the request names a tenant, and to every professional of the organization when it does not. In the second case each row carries `tenant_id`, because an integrator listing hundreds of professionals has to know whose booking it is looking at.","parameters":[{"schema":{"type":"integer","minimum":1,"maximum":200,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"host_id","required":false},{"schema":{"type":"string"},"in":"query","name":"status","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"from","required":false,"description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"to","required":false,"description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"auto_reschedule":{"type":["object","null"],"properties":{"queue_position":{"type":["integer","null"],"exclusiveMinimum":true,"minimum":0},"id":{"type":"string","format":"uuid"},"occurrence_id":{"type":"string","format":"uuid"},"preferred_start":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"status":{"type":"string","enum":["waiting","applied","withdrawn","expired"]},"result_occurrence_id":{"type":["string","null"],"format":"uuid"}},"required":["queue_position","id","occurrence_id","preferred_start","status","result_occurrence_id"],"additionalProperties":false},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"reschedule_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"deletion_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"event_type_id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"sequence":{"type":"integer"},"title":{"type":["string","null"],"minLength":1,"maxLength":160,"description":"Private display title. Not copied to provider calendars or notifications."},"availability":{"type":"string","enum":["busy","free"],"description":"Busy reserves time in the occupancy ledger; free remains visible without blocking time."},"duration_minutes":{"type":["integer","null"],"minimum":1,"maximum":1440},"external_ref":{"type":["string","null"],"description":"Caller-owned id of this booking. Not a participant id."},"session_package_id":{"type":["string","null"],"format":"uuid","description":"Balance this booking draws from. Null when the booking is not part of a package."},"tenant_metadata":{"type":"object","additionalProperties":{}},"occurrences":{"type":"array","items":{"type":"object","properties":{"recurrence_rule":{"type":"string","maxLength":1024,"description":"Rule for the occurrence’s own series, when read in booking detail."},"attendee_override":{"type":["array","null"],"items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false}},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"event_metadata":{"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":256},{"type":"number"},{"type":"boolean"},{"enum":["null"]}]},"description":"Flat, bounded opaque occurrence references owned by the integrator. No names, clinical content or credentials. Not authorization. Not projected to providers, messenger commands, inbox or public pages."},"event_details":{"type":"object","properties":{"link":{"type":["string","null"],"maxLength":800},"address":{"type":["string","null"],"minLength":1,"maxLength":1024},"description":{"type":["string","null"],"minLength":1,"maxLength":2000,"description":"Scheduling instructions visible in managed external calendars. Never include clinical or confidential notes."}},"additionalProperties":false},"conference_state":{"type":["string","null"],"enum":["pending","ready","failed"]},"root_occurrence_id":{"type":"string","format":"uuid"},"recurrence_order_local":{"type":["string","null"]},"id":{"type":"string","format":"uuid"},"booking_id":{"type":"string","format":"uuid"},"series_id":{"type":["string","null"],"format":"uuid"},"starts_at":{"type":"string"},"ends_at":{"type":"string"},"starts_local":{"type":"string"},"host_timezone":{"type":"string"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"revision":{"type":"integer"},"tz_resolution":{"type":["string","null"],"enum":["exact","shifted_forward","first_of_ambiguous"]},"dst_shift_flag":{"type":"boolean"},"rescheduled_from_id":{"type":["string","null"],"format":"uuid"},"join_url":{"type":["string","null"]},"covering_host_id":{"type":["string","null"],"format":"uuid","description":"Host delivering this occurrence when it is not the booking host. Null means the booking host."},"participant_responses":{"type":"array","items":{"type":"object","properties":{"attendee_ref":{"type":"string"},"response_status":{"type":"string","enum":["accepted","tentative","declined","needs_action"]},"response_source":{"type":"string","enum":["participant","host"]},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"responded_at":{"type":"string"},"occurrence_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["attendee_ref","response_status","version","responded_at","occurrence_revision"],"additionalProperties":false},"maxItems":50,"description":"Response for this exact revision. A host may record it on behalf of the participant or reset it to needs_action. Absence means unknown."}},"required":["id","booking_id","series_id","starts_at","ends_at","starts_local","host_timezone","status","revision","tz_resolution","dst_shift_flag","rescheduled_from_id","join_url","covering_host_id"],"additionalProperties":false},"maxItems":2048,"description":"Complete non-removed occurrence history, up to 2048 rows. Larger aggregates return 422 booking_detail_limit_exceeded without truncation; use the bounded summary and operational reconciliation."},"attendees":{"type":"array","items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false},"maxItems":50},"created_at":{"type":["string","null"]},"updated_at":{"type":["string","null"]},"tenant_id":{"type":"string","format":"uuid"}},"required":["id","status","event_type_id","host_id","sequence","external_ref","session_package_id","tenant_metadata","occurrences","attendees","created_at","updated_at"],"additionalProperties":false}},"page":{"type":"object","properties":{"next_cursor":{"type":["string","null"]},"has_more":{"type":"boolean"},"limit":{"type":"integer"}},"required":["next_cursor","has_more","limit"],"additionalProperties":false}},"required":["data","page"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/bookings \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/bookings', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/bookings\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/bookings', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/bookings/{id}":{"patch":{"operationId":"patchV1BookingsById","summary":"Update private title, availability or duration of the whole booking","tags":["bookings"],"description":"Applies to all active occurrences of the logical booking, preserving their IDs and starts. If-Match is the booking sequence. Free events and duration overrides must use internal auto-confirm types without shared resources. A duration override requires no attendees, uses civil minutes, and changes ends atomically. A title is private and does not modify provider titles or notification content.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"title":{"type":["string","null"],"minLength":1,"maxLength":160,"description":"Private display title. Not copied to provider calendars or notifications."},"availability":{"type":"string","enum":["busy","free"],"description":"Busy reserves time in the occupancy ledger; free remains visible without blocking time."},"duration_minutes":{"type":"integer","minimum":1,"maximum":1440}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."},{"schema":{"type":"string"},"in":"header","name":"if-match","required":false,"description":"Weak ETag, e.g. W/\"7\". On a booking-addressed route it carries booking.sequence; on an occurrence-addressed route it carries occurrence.revision, and the response ETag is the matching validator."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"auto_reschedule":{"type":["object","null"],"properties":{"queue_position":{"type":["integer","null"],"exclusiveMinimum":true,"minimum":0},"id":{"type":"string","format":"uuid"},"occurrence_id":{"type":"string","format":"uuid"},"preferred_start":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"status":{"type":"string","enum":["waiting","applied","withdrawn","expired"]},"result_occurrence_id":{"type":["string","null"],"format":"uuid"}},"required":["queue_position","id","occurrence_id","preferred_start","status","result_occurrence_id"],"additionalProperties":false},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"reschedule_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"deletion_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"event_type_id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"sequence":{"type":"integer"},"title":{"type":["string","null"],"minLength":1,"maxLength":160,"description":"Private display title. Not copied to provider calendars or notifications."},"availability":{"type":"string","enum":["busy","free"],"description":"Busy reserves time in the occupancy ledger; free remains visible without blocking time."},"duration_minutes":{"type":["integer","null"],"minimum":1,"maximum":1440},"external_ref":{"type":["string","null"],"description":"Caller-owned id of this booking. Not a participant id."},"session_package_id":{"type":["string","null"],"format":"uuid","description":"Balance this booking draws from. Null when the booking is not part of a package."},"tenant_metadata":{"type":"object","additionalProperties":{}},"occurrences":{"type":"array","items":{"type":"object","properties":{"recurrence_rule":{"type":"string","maxLength":1024,"description":"Rule for the occurrence’s own series, when read in booking detail."},"attendee_override":{"type":["array","null"],"items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false}},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"event_metadata":{"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":256},{"type":"number"},{"type":"boolean"},{"enum":["null"]}]},"description":"Flat, bounded opaque occurrence references owned by the integrator. No names, clinical content or credentials. Not authorization. Not projected to providers, messenger commands, inbox or public pages."},"event_details":{"type":"object","properties":{"link":{"type":["string","null"],"maxLength":800},"address":{"type":["string","null"],"minLength":1,"maxLength":1024},"description":{"type":["string","null"],"minLength":1,"maxLength":2000,"description":"Scheduling instructions visible in managed external calendars. Never include clinical or confidential notes."}},"additionalProperties":false},"conference_state":{"type":["string","null"],"enum":["pending","ready","failed"]},"root_occurrence_id":{"type":"string","format":"uuid"},"recurrence_order_local":{"type":["string","null"]},"id":{"type":"string","format":"uuid"},"booking_id":{"type":"string","format":"uuid"},"series_id":{"type":["string","null"],"format":"uuid"},"starts_at":{"type":"string"},"ends_at":{"type":"string"},"starts_local":{"type":"string"},"host_timezone":{"type":"string"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"revision":{"type":"integer"},"tz_resolution":{"type":["string","null"],"enum":["exact","shifted_forward","first_of_ambiguous"]},"dst_shift_flag":{"type":"boolean"},"rescheduled_from_id":{"type":["string","null"],"format":"uuid"},"join_url":{"type":["string","null"]},"covering_host_id":{"type":["string","null"],"format":"uuid","description":"Host delivering this occurrence when it is not the booking host. Null means the booking host."},"participant_responses":{"type":"array","items":{"type":"object","properties":{"attendee_ref":{"type":"string"},"response_status":{"type":"string","enum":["accepted","tentative","declined","needs_action"]},"response_source":{"type":"string","enum":["participant","host"]},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"responded_at":{"type":"string"},"occurrence_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["attendee_ref","response_status","version","responded_at","occurrence_revision"],"additionalProperties":false},"maxItems":50,"description":"Response for this exact revision. A host may record it on behalf of the participant or reset it to needs_action. Absence means unknown."}},"required":["id","booking_id","series_id","starts_at","ends_at","starts_local","host_timezone","status","revision","tz_resolution","dst_shift_flag","rescheduled_from_id","join_url","covering_host_id"],"additionalProperties":false},"maxItems":2048,"description":"Complete non-removed occurrence history, up to 2048 rows. Larger aggregates return 422 booking_detail_limit_exceeded without truncation; use the bounded summary and operational reconciliation."},"attendees":{"type":"array","items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false},"maxItems":50},"created_at":{"type":["string","null"]},"updated_at":{"type":["string","null"]}},"required":["id","status","event_type_id","host_id","sequence","external_ref","session_package_id","tenant_metadata","occurrences","attendees","created_at","updated_at"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000 \\\n  --request PATCH \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000', {\n  method: 'PATCH',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"PATCH\",\n    \"/v1/bookings/00000000-0000-4000-8000-000000000000\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('PATCH', 'https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]},"get":{"operationId":"getV1BookingsById","summary":"Read one booking","tags":["bookings"],"description":"Returns the complete non-removed history with at most 2048 occurrences and 50 attendees. An oversized aggregate returns 422 validation_failed with code_detail and reconciliation_required instead of a truncated booking. For calendar views, use GET /v1/bookings/summary with its interval and pagination. These technical read limits do not authorize removal or rewrite of history.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"auto_reschedule":{"type":["object","null"],"properties":{"queue_position":{"type":["integer","null"],"exclusiveMinimum":true,"minimum":0},"id":{"type":"string","format":"uuid"},"occurrence_id":{"type":"string","format":"uuid"},"preferred_start":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"status":{"type":"string","enum":["waiting","applied","withdrawn","expired"]},"result_occurrence_id":{"type":["string","null"],"format":"uuid"}},"required":["queue_position","id","occurrence_id","preferred_start","status","result_occurrence_id"],"additionalProperties":false},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"reschedule_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"deletion_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"event_type_id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"sequence":{"type":"integer"},"title":{"type":["string","null"],"minLength":1,"maxLength":160,"description":"Private display title. Not copied to provider calendars or notifications."},"availability":{"type":"string","enum":["busy","free"],"description":"Busy reserves time in the occupancy ledger; free remains visible without blocking time."},"duration_minutes":{"type":["integer","null"],"minimum":1,"maximum":1440},"external_ref":{"type":["string","null"],"description":"Caller-owned id of this booking. Not a participant id."},"session_package_id":{"type":["string","null"],"format":"uuid","description":"Balance this booking draws from. Null when the booking is not part of a package."},"tenant_metadata":{"type":"object","additionalProperties":{}},"occurrences":{"type":"array","items":{"type":"object","properties":{"recurrence_rule":{"type":"string","maxLength":1024,"description":"Rule for the occurrence’s own series, when read in booking detail."},"attendee_override":{"type":["array","null"],"items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false}},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"event_metadata":{"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":256},{"type":"number"},{"type":"boolean"},{"enum":["null"]}]},"description":"Flat, bounded opaque occurrence references owned by the integrator. No names, clinical content or credentials. Not authorization. Not projected to providers, messenger commands, inbox or public pages."},"event_details":{"type":"object","properties":{"link":{"type":["string","null"],"maxLength":800},"address":{"type":["string","null"],"minLength":1,"maxLength":1024},"description":{"type":["string","null"],"minLength":1,"maxLength":2000,"description":"Scheduling instructions visible in managed external calendars. Never include clinical or confidential notes."}},"additionalProperties":false},"conference_state":{"type":["string","null"],"enum":["pending","ready","failed"]},"root_occurrence_id":{"type":"string","format":"uuid"},"recurrence_order_local":{"type":["string","null"]},"id":{"type":"string","format":"uuid"},"booking_id":{"type":"string","format":"uuid"},"series_id":{"type":["string","null"],"format":"uuid"},"starts_at":{"type":"string"},"ends_at":{"type":"string"},"starts_local":{"type":"string"},"host_timezone":{"type":"string"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"revision":{"type":"integer"},"tz_resolution":{"type":["string","null"],"enum":["exact","shifted_forward","first_of_ambiguous"]},"dst_shift_flag":{"type":"boolean"},"rescheduled_from_id":{"type":["string","null"],"format":"uuid"},"join_url":{"type":["string","null"]},"covering_host_id":{"type":["string","null"],"format":"uuid","description":"Host delivering this occurrence when it is not the booking host. Null means the booking host."},"participant_responses":{"type":"array","items":{"type":"object","properties":{"attendee_ref":{"type":"string"},"response_status":{"type":"string","enum":["accepted","tentative","declined","needs_action"]},"response_source":{"type":"string","enum":["participant","host"]},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"responded_at":{"type":"string"},"occurrence_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["attendee_ref","response_status","version","responded_at","occurrence_revision"],"additionalProperties":false},"maxItems":50,"description":"Response for this exact revision. A host may record it on behalf of the participant or reset it to needs_action. Absence means unknown."}},"required":["id","booking_id","series_id","starts_at","ends_at","starts_local","host_timezone","status","revision","tz_resolution","dst_shift_flag","rescheduled_from_id","join_url","covering_host_id"],"additionalProperties":false},"maxItems":2048,"description":"Complete non-removed occurrence history, up to 2048 rows. Larger aggregates return 422 booking_detail_limit_exceeded without truncation; use the bounded summary and operational reconciliation."},"attendees":{"type":"array","items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false},"maxItems":50},"created_at":{"type":["string","null"]},"updated_at":{"type":["string","null"]}},"required":["id","status","event_type_id","host_id","sequence","external_ref","session_package_id","tenant_metadata","occurrences","attendees","created_at","updated_at"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000 \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/bookings/00000000-0000-4000-8000-000000000000\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/bookings/{id}/auto-reschedule/withdraw":{"post":{"operationId":"postV1BookingsByIdAutoRescheduleWithdraw","summary":"Withdraw automatic preferred-time replacement","tags":["bookings"],"description":"Withdraw automatic preferred-time replacement","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/auto-reschedule/withdraw \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/auto-reschedule/withdraw', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/bookings/00000000-0000-4000-8000-000000000000/auto-reschedule/withdraw\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/auto-reschedule/withdraw', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/occurrences/{id}/reschedule":{"post":{"operationId":"postV1OccurrencesByIdReschedule","summary":"Move one occurrence, keeping the booking id","tags":["bookings"],"description":"The booking id the tenant stored is preserved. The old occurrence is retired and a new one is created, linked through rescheduled_from_id. `If-Match` carries the occurrence revision and the returned `ETag` is the replacement occurrence revision, so the two round trip; `Anam-Occurrence-Id` names the occurrence that validator belongs to. Optional expected_booking_sequence also checks the entire aggregate in the same transaction; it does not change the meaning of If-Match. Freeze both validators for idempotent retry.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"allow_google_conflict":{"type":"boolean","enum":[true],"description":"Trusted Google busy override for this move."},"justification":{"type":"string","minLength":1,"maxLength":500},"starts_at":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"expected_booking_sequence":{"type":"integer","minimum":0,"maximum":9007199254740991,"exclusiveMinimum":true,"description":"Optional aggregate CAS in addition to the occurrence revision in If-Match. Validated in the same transaction before scheduling or external effects."},"hold_token":{"type":["string","null"]},"allow_outside_availability":{"type":"boolean","description":"Trusted scheduling override; occupancy and blocks remain enforced."},"reason":{"type":["string","null"],"maxLength":500},"rescheduled_by":{"type":["string","null"],"maxLength":100,"description":"`attendee` is bound by the event type reschedule notice. The host is not."}},"required":["starts_at"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."},{"schema":{"type":"string"},"in":"header","name":"if-match","required":false,"description":"Weak ETag, e.g. W/\"7\". On a booking-addressed route it carries booking.sequence; on an occurrence-addressed route it carries occurrence.revision, and the response ETag is the matching validator."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"auto_reschedule":{"type":["object","null"],"properties":{"queue_position":{"type":["integer","null"],"exclusiveMinimum":true,"minimum":0},"id":{"type":"string","format":"uuid"},"occurrence_id":{"type":"string","format":"uuid"},"preferred_start":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"status":{"type":"string","enum":["waiting","applied","withdrawn","expired"]},"result_occurrence_id":{"type":["string","null"],"format":"uuid"}},"required":["queue_position","id","occurrence_id","preferred_start","status","result_occurrence_id"],"additionalProperties":false},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"reschedule_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"deletion_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"event_type_id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"sequence":{"type":"integer"},"title":{"type":["string","null"],"minLength":1,"maxLength":160,"description":"Private display title. Not copied to provider calendars or notifications."},"availability":{"type":"string","enum":["busy","free"],"description":"Busy reserves time in the occupancy ledger; free remains visible without blocking time."},"duration_minutes":{"type":["integer","null"],"minimum":1,"maximum":1440},"external_ref":{"type":["string","null"],"description":"Caller-owned id of this booking. Not a participant id."},"session_package_id":{"type":["string","null"],"format":"uuid","description":"Balance this booking draws from. Null when the booking is not part of a package."},"tenant_metadata":{"type":"object","additionalProperties":{}},"occurrences":{"type":"array","items":{"type":"object","properties":{"recurrence_rule":{"type":"string","maxLength":1024,"description":"Rule for the occurrence’s own series, when read in booking detail."},"attendee_override":{"type":["array","null"],"items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false}},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"event_metadata":{"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":256},{"type":"number"},{"type":"boolean"},{"enum":["null"]}]},"description":"Flat, bounded opaque occurrence references owned by the integrator. No names, clinical content or credentials. Not authorization. Not projected to providers, messenger commands, inbox or public pages."},"event_details":{"type":"object","properties":{"link":{"type":["string","null"],"maxLength":800},"address":{"type":["string","null"],"minLength":1,"maxLength":1024},"description":{"type":["string","null"],"minLength":1,"maxLength":2000,"description":"Scheduling instructions visible in managed external calendars. Never include clinical or confidential notes."}},"additionalProperties":false},"conference_state":{"type":["string","null"],"enum":["pending","ready","failed"]},"root_occurrence_id":{"type":"string","format":"uuid"},"recurrence_order_local":{"type":["string","null"]},"id":{"type":"string","format":"uuid"},"booking_id":{"type":"string","format":"uuid"},"series_id":{"type":["string","null"],"format":"uuid"},"starts_at":{"type":"string"},"ends_at":{"type":"string"},"starts_local":{"type":"string"},"host_timezone":{"type":"string"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"revision":{"type":"integer"},"tz_resolution":{"type":["string","null"],"enum":["exact","shifted_forward","first_of_ambiguous"]},"dst_shift_flag":{"type":"boolean"},"rescheduled_from_id":{"type":["string","null"],"format":"uuid"},"join_url":{"type":["string","null"]},"covering_host_id":{"type":["string","null"],"format":"uuid","description":"Host delivering this occurrence when it is not the booking host. Null means the booking host."},"participant_responses":{"type":"array","items":{"type":"object","properties":{"attendee_ref":{"type":"string"},"response_status":{"type":"string","enum":["accepted","tentative","declined","needs_action"]},"response_source":{"type":"string","enum":["participant","host"]},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"responded_at":{"type":"string"},"occurrence_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["attendee_ref","response_status","version","responded_at","occurrence_revision"],"additionalProperties":false},"maxItems":50,"description":"Response for this exact revision. A host may record it on behalf of the participant or reset it to needs_action. Absence means unknown."}},"required":["id","booking_id","series_id","starts_at","ends_at","starts_local","host_timezone","status","revision","tz_resolution","dst_shift_flag","rescheduled_from_id","join_url","covering_host_id"],"additionalProperties":false},"maxItems":2048,"description":"Complete non-removed occurrence history, up to 2048 rows. Larger aggregates return 422 booking_detail_limit_exceeded without truncation; use the bounded summary and operational reconciliation."},"attendees":{"type":"array","items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false},"maxItems":50},"created_at":{"type":["string","null"]},"updated_at":{"type":["string","null"]}},"required":["id","status","event_type_id","host_id","sequence","external_ref","session_package_id","tenant_metadata","occurrences","attendees","created_at","updated_at"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000/reschedule \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000/reschedule', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/occurrences/00000000-0000-4000-8000-000000000000/reschedule\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000/reschedule', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/occurrences/{id}/event-details":{"patch":{"operationId":"patchV1OccurrencesByIdEventDetails","summary":"Update scheduling details for one occurrence","tags":["bookings"],"description":"Omitted fields stay unchanged. Null clears a field. The booking defaults and other dates stay unchanged. Details are used on the managed external calendar. The removal flag detaches a generated conference from this occurrence and updates future reminders.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"link":{"type":["string","null"],"maxLength":800},"address":{"type":["string","null"],"minLength":1,"maxLength":1024},"description":{"type":["string","null"],"minLength":1,"maxLength":2000,"description":"Scheduling instructions visible in managed external calendars. Never include clinical or confidential notes."},"remove_conference":{"type":"boolean","enum":[true],"description":"Detach the generated conference from this occurrence."}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."},{"schema":{"type":"string"},"in":"header","name":"if-match","required":false,"description":"Weak ETag, e.g. W/\"7\". On a booking-addressed route it carries booking.sequence; on an occurrence-addressed route it carries occurrence.revision, and the response ETag is the matching validator."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"auto_reschedule":{"type":["object","null"],"properties":{"queue_position":{"type":["integer","null"],"exclusiveMinimum":true,"minimum":0},"id":{"type":"string","format":"uuid"},"occurrence_id":{"type":"string","format":"uuid"},"preferred_start":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"status":{"type":"string","enum":["waiting","applied","withdrawn","expired"]},"result_occurrence_id":{"type":["string","null"],"format":"uuid"}},"required":["queue_position","id","occurrence_id","preferred_start","status","result_occurrence_id"],"additionalProperties":false},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"reschedule_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"deletion_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"event_type_id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"sequence":{"type":"integer"},"title":{"type":["string","null"],"minLength":1,"maxLength":160,"description":"Private display title. Not copied to provider calendars or notifications."},"availability":{"type":"string","enum":["busy","free"],"description":"Busy reserves time in the occupancy ledger; free remains visible without blocking time."},"duration_minutes":{"type":["integer","null"],"minimum":1,"maximum":1440},"external_ref":{"type":["string","null"],"description":"Caller-owned id of this booking. Not a participant id."},"session_package_id":{"type":["string","null"],"format":"uuid","description":"Balance this booking draws from. Null when the booking is not part of a package."},"tenant_metadata":{"type":"object","additionalProperties":{}},"occurrences":{"type":"array","items":{"type":"object","properties":{"recurrence_rule":{"type":"string","maxLength":1024,"description":"Rule for the occurrence’s own series, when read in booking detail."},"attendee_override":{"type":["array","null"],"items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false}},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"event_metadata":{"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":256},{"type":"number"},{"type":"boolean"},{"enum":["null"]}]},"description":"Flat, bounded opaque occurrence references owned by the integrator. No names, clinical content or credentials. Not authorization. Not projected to providers, messenger commands, inbox or public pages."},"event_details":{"type":"object","properties":{"link":{"type":["string","null"],"maxLength":800},"address":{"type":["string","null"],"minLength":1,"maxLength":1024},"description":{"type":["string","null"],"minLength":1,"maxLength":2000,"description":"Scheduling instructions visible in managed external calendars. Never include clinical or confidential notes."}},"additionalProperties":false},"conference_state":{"type":["string","null"],"enum":["pending","ready","failed"]},"root_occurrence_id":{"type":"string","format":"uuid"},"recurrence_order_local":{"type":["string","null"]},"id":{"type":"string","format":"uuid"},"booking_id":{"type":"string","format":"uuid"},"series_id":{"type":["string","null"],"format":"uuid"},"starts_at":{"type":"string"},"ends_at":{"type":"string"},"starts_local":{"type":"string"},"host_timezone":{"type":"string"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"revision":{"type":"integer"},"tz_resolution":{"type":["string","null"],"enum":["exact","shifted_forward","first_of_ambiguous"]},"dst_shift_flag":{"type":"boolean"},"rescheduled_from_id":{"type":["string","null"],"format":"uuid"},"join_url":{"type":["string","null"]},"covering_host_id":{"type":["string","null"],"format":"uuid","description":"Host delivering this occurrence when it is not the booking host. Null means the booking host."},"participant_responses":{"type":"array","items":{"type":"object","properties":{"attendee_ref":{"type":"string"},"response_status":{"type":"string","enum":["accepted","tentative","declined","needs_action"]},"response_source":{"type":"string","enum":["participant","host"]},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"responded_at":{"type":"string"},"occurrence_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["attendee_ref","response_status","version","responded_at","occurrence_revision"],"additionalProperties":false},"maxItems":50,"description":"Response for this exact revision. A host may record it on behalf of the participant or reset it to needs_action. Absence means unknown."}},"required":["id","booking_id","series_id","starts_at","ends_at","starts_local","host_timezone","status","revision","tz_resolution","dst_shift_flag","rescheduled_from_id","join_url","covering_host_id"],"additionalProperties":false},"maxItems":2048,"description":"Complete non-removed occurrence history, up to 2048 rows. Larger aggregates return 422 booking_detail_limit_exceeded without truncation; use the bounded summary and operational reconciliation."},"attendees":{"type":"array","items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false},"maxItems":50},"created_at":{"type":["string","null"]},"updated_at":{"type":["string","null"]}},"required":["id","status","event_type_id","host_id","sequence","external_ref","session_package_id","tenant_metadata","occurrences","attendees","created_at","updated_at"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000/event-details \\\n  --request PATCH \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000/event-details', {\n  method: 'PATCH',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"PATCH\",\n    \"/v1/occurrences/00000000-0000-4000-8000-000000000000/event-details\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('PATCH', 'https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000/event-details', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/occurrences/{id}/event-metadata":{"patch":{"operationId":"patchV1OccurrencesByIdEventMetadata","summary":"Replace opaque occurrence metadata","tags":["bookings"],"description":"Replaces the integrator-owned event_metadata bag for one occurrence. If-Match is the occurrence revision. The field is never projected to providers, messenger commands, inbox or public pages, and never authorizes access. Nested objects and arrays are refused at the schema boundary.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"event_metadata":{"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":256},{"type":"number"},{"type":"boolean"},{"enum":["null"]}]},"description":"Flat, bounded opaque occurrence references owned by the integrator. No names, clinical content or credentials. Not authorization. Not projected to providers, messenger commands, inbox or public pages."}},"required":["event_metadata"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."},{"schema":{"type":"string"},"in":"header","name":"if-match","required":false,"description":"Weak ETag, e.g. W/\"7\". On a booking-addressed route it carries booking.sequence; on an occurrence-addressed route it carries occurrence.revision, and the response ETag is the matching validator."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"auto_reschedule":{"type":["object","null"],"properties":{"queue_position":{"type":["integer","null"],"exclusiveMinimum":true,"minimum":0},"id":{"type":"string","format":"uuid"},"occurrence_id":{"type":"string","format":"uuid"},"preferred_start":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"status":{"type":"string","enum":["waiting","applied","withdrawn","expired"]},"result_occurrence_id":{"type":["string","null"],"format":"uuid"}},"required":["queue_position","id","occurrence_id","preferred_start","status","result_occurrence_id"],"additionalProperties":false},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"reschedule_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"deletion_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"event_type_id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"sequence":{"type":"integer"},"title":{"type":["string","null"],"minLength":1,"maxLength":160,"description":"Private display title. Not copied to provider calendars or notifications."},"availability":{"type":"string","enum":["busy","free"],"description":"Busy reserves time in the occupancy ledger; free remains visible without blocking time."},"duration_minutes":{"type":["integer","null"],"minimum":1,"maximum":1440},"external_ref":{"type":["string","null"],"description":"Caller-owned id of this booking. Not a participant id."},"session_package_id":{"type":["string","null"],"format":"uuid","description":"Balance this booking draws from. Null when the booking is not part of a package."},"tenant_metadata":{"type":"object","additionalProperties":{}},"occurrences":{"type":"array","items":{"type":"object","properties":{"recurrence_rule":{"type":"string","maxLength":1024,"description":"Rule for the occurrence’s own series, when read in booking detail."},"attendee_override":{"type":["array","null"],"items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false}},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"event_metadata":{"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":256},{"type":"number"},{"type":"boolean"},{"enum":["null"]}]},"description":"Flat, bounded opaque occurrence references owned by the integrator. No names, clinical content or credentials. Not authorization. Not projected to providers, messenger commands, inbox or public pages."},"event_details":{"type":"object","properties":{"link":{"type":["string","null"],"maxLength":800},"address":{"type":["string","null"],"minLength":1,"maxLength":1024},"description":{"type":["string","null"],"minLength":1,"maxLength":2000,"description":"Scheduling instructions visible in managed external calendars. Never include clinical or confidential notes."}},"additionalProperties":false},"conference_state":{"type":["string","null"],"enum":["pending","ready","failed"]},"root_occurrence_id":{"type":"string","format":"uuid"},"recurrence_order_local":{"type":["string","null"]},"id":{"type":"string","format":"uuid"},"booking_id":{"type":"string","format":"uuid"},"series_id":{"type":["string","null"],"format":"uuid"},"starts_at":{"type":"string"},"ends_at":{"type":"string"},"starts_local":{"type":"string"},"host_timezone":{"type":"string"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"revision":{"type":"integer"},"tz_resolution":{"type":["string","null"],"enum":["exact","shifted_forward","first_of_ambiguous"]},"dst_shift_flag":{"type":"boolean"},"rescheduled_from_id":{"type":["string","null"],"format":"uuid"},"join_url":{"type":["string","null"]},"covering_host_id":{"type":["string","null"],"format":"uuid","description":"Host delivering this occurrence when it is not the booking host. Null means the booking host."},"participant_responses":{"type":"array","items":{"type":"object","properties":{"attendee_ref":{"type":"string"},"response_status":{"type":"string","enum":["accepted","tentative","declined","needs_action"]},"response_source":{"type":"string","enum":["participant","host"]},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"responded_at":{"type":"string"},"occurrence_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["attendee_ref","response_status","version","responded_at","occurrence_revision"],"additionalProperties":false},"maxItems":50,"description":"Response for this exact revision. A host may record it on behalf of the participant or reset it to needs_action. Absence means unknown."}},"required":["id","booking_id","series_id","starts_at","ends_at","starts_local","host_timezone","status","revision","tz_resolution","dst_shift_flag","rescheduled_from_id","join_url","covering_host_id"],"additionalProperties":false},"maxItems":2048,"description":"Complete non-removed occurrence history, up to 2048 rows. Larger aggregates return 422 booking_detail_limit_exceeded without truncation; use the bounded summary and operational reconciliation."},"attendees":{"type":"array","items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false},"maxItems":50},"created_at":{"type":["string","null"]},"updated_at":{"type":["string","null"]}},"required":["id","status","event_type_id","host_id","sequence","external_ref","session_package_id","tenant_metadata","occurrences","attendees","created_at","updated_at"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000/event-metadata \\\n  --request PATCH \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000/event-metadata', {\n  method: 'PATCH',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"PATCH\",\n    \"/v1/occurrences/00000000-0000-4000-8000-000000000000/event-metadata\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('PATCH', 'https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000/event-metadata', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/bookings/{id}/cancel":{"post":{"operationId":"postV1BookingsByIdCancel","summary":"Cancel a booking and all of its live occurrences","tags":["bookings"],"description":"Cancel a booking and all of its live occurrences","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"justification":{"type":"string","minLength":1,"maxLength":500},"reason":{"type":["string","null"],"maxLength":500},"cancelled_by":{"type":["string","null"],"maxLength":100,"description":"`attendee` is bound by the event type cancel notice. The host is not."},"effects":{"type":"string","enum":["notices","silent"],"default":"notices"}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."},{"schema":{"type":"string"},"in":"header","name":"if-match","required":false,"description":"Weak ETag, e.g. W/\"7\". On a booking-addressed route it carries booking.sequence; on an occurrence-addressed route it carries occurrence.revision, and the response ETag is the matching validator."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"auto_reschedule":{"type":["object","null"],"properties":{"queue_position":{"type":["integer","null"],"exclusiveMinimum":true,"minimum":0},"id":{"type":"string","format":"uuid"},"occurrence_id":{"type":"string","format":"uuid"},"preferred_start":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"status":{"type":"string","enum":["waiting","applied","withdrawn","expired"]},"result_occurrence_id":{"type":["string","null"],"format":"uuid"}},"required":["queue_position","id","occurrence_id","preferred_start","status","result_occurrence_id"],"additionalProperties":false},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"reschedule_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"deletion_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"event_type_id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"sequence":{"type":"integer"},"title":{"type":["string","null"],"minLength":1,"maxLength":160,"description":"Private display title. Not copied to provider calendars or notifications."},"availability":{"type":"string","enum":["busy","free"],"description":"Busy reserves time in the occupancy ledger; free remains visible without blocking time."},"duration_minutes":{"type":["integer","null"],"minimum":1,"maximum":1440},"external_ref":{"type":["string","null"],"description":"Caller-owned id of this booking. Not a participant id."},"session_package_id":{"type":["string","null"],"format":"uuid","description":"Balance this booking draws from. Null when the booking is not part of a package."},"tenant_metadata":{"type":"object","additionalProperties":{}},"occurrences":{"type":"array","items":{"type":"object","properties":{"recurrence_rule":{"type":"string","maxLength":1024,"description":"Rule for the occurrence’s own series, when read in booking detail."},"attendee_override":{"type":["array","null"],"items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false}},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"event_metadata":{"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":256},{"type":"number"},{"type":"boolean"},{"enum":["null"]}]},"description":"Flat, bounded opaque occurrence references owned by the integrator. No names, clinical content or credentials. Not authorization. Not projected to providers, messenger commands, inbox or public pages."},"event_details":{"type":"object","properties":{"link":{"type":["string","null"],"maxLength":800},"address":{"type":["string","null"],"minLength":1,"maxLength":1024},"description":{"type":["string","null"],"minLength":1,"maxLength":2000,"description":"Scheduling instructions visible in managed external calendars. Never include clinical or confidential notes."}},"additionalProperties":false},"conference_state":{"type":["string","null"],"enum":["pending","ready","failed"]},"root_occurrence_id":{"type":"string","format":"uuid"},"recurrence_order_local":{"type":["string","null"]},"id":{"type":"string","format":"uuid"},"booking_id":{"type":"string","format":"uuid"},"series_id":{"type":["string","null"],"format":"uuid"},"starts_at":{"type":"string"},"ends_at":{"type":"string"},"starts_local":{"type":"string"},"host_timezone":{"type":"string"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"revision":{"type":"integer"},"tz_resolution":{"type":["string","null"],"enum":["exact","shifted_forward","first_of_ambiguous"]},"dst_shift_flag":{"type":"boolean"},"rescheduled_from_id":{"type":["string","null"],"format":"uuid"},"join_url":{"type":["string","null"]},"covering_host_id":{"type":["string","null"],"format":"uuid","description":"Host delivering this occurrence when it is not the booking host. Null means the booking host."},"participant_responses":{"type":"array","items":{"type":"object","properties":{"attendee_ref":{"type":"string"},"response_status":{"type":"string","enum":["accepted","tentative","declined","needs_action"]},"response_source":{"type":"string","enum":["participant","host"]},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"responded_at":{"type":"string"},"occurrence_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["attendee_ref","response_status","version","responded_at","occurrence_revision"],"additionalProperties":false},"maxItems":50,"description":"Response for this exact revision. A host may record it on behalf of the participant or reset it to needs_action. Absence means unknown."}},"required":["id","booking_id","series_id","starts_at","ends_at","starts_local","host_timezone","status","revision","tz_resolution","dst_shift_flag","rescheduled_from_id","join_url","covering_host_id"],"additionalProperties":false},"maxItems":2048,"description":"Complete non-removed occurrence history, up to 2048 rows. Larger aggregates return 422 booking_detail_limit_exceeded without truncation; use the bounded summary and operational reconciliation."},"attendees":{"type":"array","items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false},"maxItems":50},"created_at":{"type":["string","null"]},"updated_at":{"type":["string","null"]}},"required":["id","status","event_type_id","host_id","sequence","external_ref","session_package_id","tenant_metadata","occurrences","attendees","created_at","updated_at"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/cancel \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/cancel', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/bookings/00000000-0000-4000-8000-000000000000/cancel\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/cancel', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/bookings/{id}/attendees/withdraw":{"post":{"operationId":"postV1BookingsByIdAttendeesWithdraw","summary":"One participant leaves the session","tags":["bookings"],"description":"A joint session is the party: the person who leaves cancels it, and the others are told. A group booking is one seat: leaving it releases that seat and leaves the other bookings at that start in place. An individual session is that one person.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"attendee_ref":{"type":"string","minLength":1,"maxLength":255},"cancelled_by":{"type":"string","maxLength":100}},"required":["attendee_ref"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."},{"schema":{"type":"string"},"in":"header","name":"if-match","required":false,"description":"Weak ETag, e.g. W/\"7\". On a booking-addressed route it carries booking.sequence; on an occurrence-addressed route it carries occurrence.revision, and the response ETag is the matching validator."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"auto_reschedule":{"type":["object","null"],"properties":{"queue_position":{"type":["integer","null"],"exclusiveMinimum":true,"minimum":0},"id":{"type":"string","format":"uuid"},"occurrence_id":{"type":"string","format":"uuid"},"preferred_start":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"status":{"type":"string","enum":["waiting","applied","withdrawn","expired"]},"result_occurrence_id":{"type":["string","null"],"format":"uuid"}},"required":["queue_position","id","occurrence_id","preferred_start","status","result_occurrence_id"],"additionalProperties":false},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"reschedule_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"deletion_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"event_type_id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"sequence":{"type":"integer"},"title":{"type":["string","null"],"minLength":1,"maxLength":160,"description":"Private display title. Not copied to provider calendars or notifications."},"availability":{"type":"string","enum":["busy","free"],"description":"Busy reserves time in the occupancy ledger; free remains visible without blocking time."},"duration_minutes":{"type":["integer","null"],"minimum":1,"maximum":1440},"external_ref":{"type":["string","null"],"description":"Caller-owned id of this booking. Not a participant id."},"session_package_id":{"type":["string","null"],"format":"uuid","description":"Balance this booking draws from. Null when the booking is not part of a package."},"tenant_metadata":{"type":"object","additionalProperties":{}},"occurrences":{"type":"array","items":{"type":"object","properties":{"recurrence_rule":{"type":"string","maxLength":1024,"description":"Rule for the occurrence’s own series, when read in booking detail."},"attendee_override":{"type":["array","null"],"items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false}},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"event_metadata":{"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":256},{"type":"number"},{"type":"boolean"},{"enum":["null"]}]},"description":"Flat, bounded opaque occurrence references owned by the integrator. No names, clinical content or credentials. Not authorization. Not projected to providers, messenger commands, inbox or public pages."},"event_details":{"type":"object","properties":{"link":{"type":["string","null"],"maxLength":800},"address":{"type":["string","null"],"minLength":1,"maxLength":1024},"description":{"type":["string","null"],"minLength":1,"maxLength":2000,"description":"Scheduling instructions visible in managed external calendars. Never include clinical or confidential notes."}},"additionalProperties":false},"conference_state":{"type":["string","null"],"enum":["pending","ready","failed"]},"root_occurrence_id":{"type":"string","format":"uuid"},"recurrence_order_local":{"type":["string","null"]},"id":{"type":"string","format":"uuid"},"booking_id":{"type":"string","format":"uuid"},"series_id":{"type":["string","null"],"format":"uuid"},"starts_at":{"type":"string"},"ends_at":{"type":"string"},"starts_local":{"type":"string"},"host_timezone":{"type":"string"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"revision":{"type":"integer"},"tz_resolution":{"type":["string","null"],"enum":["exact","shifted_forward","first_of_ambiguous"]},"dst_shift_flag":{"type":"boolean"},"rescheduled_from_id":{"type":["string","null"],"format":"uuid"},"join_url":{"type":["string","null"]},"covering_host_id":{"type":["string","null"],"format":"uuid","description":"Host delivering this occurrence when it is not the booking host. Null means the booking host."},"participant_responses":{"type":"array","items":{"type":"object","properties":{"attendee_ref":{"type":"string"},"response_status":{"type":"string","enum":["accepted","tentative","declined","needs_action"]},"response_source":{"type":"string","enum":["participant","host"]},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"responded_at":{"type":"string"},"occurrence_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["attendee_ref","response_status","version","responded_at","occurrence_revision"],"additionalProperties":false},"maxItems":50,"description":"Response for this exact revision. A host may record it on behalf of the participant or reset it to needs_action. Absence means unknown."}},"required":["id","booking_id","series_id","starts_at","ends_at","starts_local","host_timezone","status","revision","tz_resolution","dst_shift_flag","rescheduled_from_id","join_url","covering_host_id"],"additionalProperties":false},"maxItems":2048,"description":"Complete non-removed occurrence history, up to 2048 rows. Larger aggregates return 422 booking_detail_limit_exceeded without truncation; use the bounded summary and operational reconciliation."},"attendees":{"type":"array","items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false},"maxItems":50},"created_at":{"type":["string","null"]},"updated_at":{"type":["string","null"]}},"required":["id","status","event_type_id","host_id","sequence","external_ref","session_package_id","tenant_metadata","occurrences","attendees","created_at","updated_at"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/attendees/withdraw \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/attendees/withdraw', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/bookings/00000000-0000-4000-8000-000000000000/attendees/withdraw\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/attendees/withdraw', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/bookings/{id}/approve":{"post":{"operationId":"postV1BookingsByIdApprove","summary":"Approve a booking awaiting the host","tags":["bookings"],"description":"Approve a booking awaiting the host","requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"not":{}},{"type":"object","properties":{"reason":{"type":["string","null"],"maxLength":500}},"additionalProperties":false}]}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."},{"schema":{"type":"string"},"in":"header","name":"if-match","required":false,"description":"Weak ETag, e.g. W/\"7\". On a booking-addressed route it carries booking.sequence; on an occurrence-addressed route it carries occurrence.revision, and the response ETag is the matching validator."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"auto_reschedule":{"type":["object","null"],"properties":{"queue_position":{"type":["integer","null"],"exclusiveMinimum":true,"minimum":0},"id":{"type":"string","format":"uuid"},"occurrence_id":{"type":"string","format":"uuid"},"preferred_start":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"status":{"type":"string","enum":["waiting","applied","withdrawn","expired"]},"result_occurrence_id":{"type":["string","null"],"format":"uuid"}},"required":["queue_position","id","occurrence_id","preferred_start","status","result_occurrence_id"],"additionalProperties":false},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"reschedule_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"deletion_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"event_type_id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"sequence":{"type":"integer"},"title":{"type":["string","null"],"minLength":1,"maxLength":160,"description":"Private display title. Not copied to provider calendars or notifications."},"availability":{"type":"string","enum":["busy","free"],"description":"Busy reserves time in the occupancy ledger; free remains visible without blocking time."},"duration_minutes":{"type":["integer","null"],"minimum":1,"maximum":1440},"external_ref":{"type":["string","null"],"description":"Caller-owned id of this booking. Not a participant id."},"session_package_id":{"type":["string","null"],"format":"uuid","description":"Balance this booking draws from. Null when the booking is not part of a package."},"tenant_metadata":{"type":"object","additionalProperties":{}},"occurrences":{"type":"array","items":{"type":"object","properties":{"recurrence_rule":{"type":"string","maxLength":1024,"description":"Rule for the occurrence’s own series, when read in booking detail."},"attendee_override":{"type":["array","null"],"items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false}},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"event_metadata":{"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":256},{"type":"number"},{"type":"boolean"},{"enum":["null"]}]},"description":"Flat, bounded opaque occurrence references owned by the integrator. No names, clinical content or credentials. Not authorization. Not projected to providers, messenger commands, inbox or public pages."},"event_details":{"type":"object","properties":{"link":{"type":["string","null"],"maxLength":800},"address":{"type":["string","null"],"minLength":1,"maxLength":1024},"description":{"type":["string","null"],"minLength":1,"maxLength":2000,"description":"Scheduling instructions visible in managed external calendars. Never include clinical or confidential notes."}},"additionalProperties":false},"conference_state":{"type":["string","null"],"enum":["pending","ready","failed"]},"root_occurrence_id":{"type":"string","format":"uuid"},"recurrence_order_local":{"type":["string","null"]},"id":{"type":"string","format":"uuid"},"booking_id":{"type":"string","format":"uuid"},"series_id":{"type":["string","null"],"format":"uuid"},"starts_at":{"type":"string"},"ends_at":{"type":"string"},"starts_local":{"type":"string"},"host_timezone":{"type":"string"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"revision":{"type":"integer"},"tz_resolution":{"type":["string","null"],"enum":["exact","shifted_forward","first_of_ambiguous"]},"dst_shift_flag":{"type":"boolean"},"rescheduled_from_id":{"type":["string","null"],"format":"uuid"},"join_url":{"type":["string","null"]},"covering_host_id":{"type":["string","null"],"format":"uuid","description":"Host delivering this occurrence when it is not the booking host. Null means the booking host."},"participant_responses":{"type":"array","items":{"type":"object","properties":{"attendee_ref":{"type":"string"},"response_status":{"type":"string","enum":["accepted","tentative","declined","needs_action"]},"response_source":{"type":"string","enum":["participant","host"]},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"responded_at":{"type":"string"},"occurrence_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["attendee_ref","response_status","version","responded_at","occurrence_revision"],"additionalProperties":false},"maxItems":50,"description":"Response for this exact revision. A host may record it on behalf of the participant or reset it to needs_action. Absence means unknown."}},"required":["id","booking_id","series_id","starts_at","ends_at","starts_local","host_timezone","status","revision","tz_resolution","dst_shift_flag","rescheduled_from_id","join_url","covering_host_id"],"additionalProperties":false},"maxItems":2048,"description":"Complete non-removed occurrence history, up to 2048 rows. Larger aggregates return 422 booking_detail_limit_exceeded without truncation; use the bounded summary and operational reconciliation."},"attendees":{"type":"array","items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false},"maxItems":50},"created_at":{"type":["string","null"]},"updated_at":{"type":["string","null"]}},"required":["id","status","event_type_id","host_id","sequence","external_ref","session_package_id","tenant_metadata","occurrences","attendees","created_at","updated_at"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/approve \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/approve', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/bookings/00000000-0000-4000-8000-000000000000/approve\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/approve', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/bookings/{id}/decline":{"post":{"operationId":"postV1BookingsByIdDecline","summary":"Decline a booking awaiting the host","tags":["bookings"],"description":"Decline a booking awaiting the host","requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"not":{}},{"type":"object","properties":{"reason":{"type":["string","null"],"maxLength":500},"participant_message":{"type":"string","minLength":1,"maxLength":240}},"additionalProperties":false}]}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."},{"schema":{"type":"string"},"in":"header","name":"if-match","required":false,"description":"Weak ETag, e.g. W/\"7\". On a booking-addressed route it carries booking.sequence; on an occurrence-addressed route it carries occurrence.revision, and the response ETag is the matching validator."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"auto_reschedule":{"type":["object","null"],"properties":{"queue_position":{"type":["integer","null"],"exclusiveMinimum":true,"minimum":0},"id":{"type":"string","format":"uuid"},"occurrence_id":{"type":"string","format":"uuid"},"preferred_start":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"status":{"type":"string","enum":["waiting","applied","withdrawn","expired"]},"result_occurrence_id":{"type":["string","null"],"format":"uuid"}},"required":["queue_position","id","occurrence_id","preferred_start","status","result_occurrence_id"],"additionalProperties":false},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"reschedule_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"deletion_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"event_type_id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"sequence":{"type":"integer"},"title":{"type":["string","null"],"minLength":1,"maxLength":160,"description":"Private display title. Not copied to provider calendars or notifications."},"availability":{"type":"string","enum":["busy","free"],"description":"Busy reserves time in the occupancy ledger; free remains visible without blocking time."},"duration_minutes":{"type":["integer","null"],"minimum":1,"maximum":1440},"external_ref":{"type":["string","null"],"description":"Caller-owned id of this booking. Not a participant id."},"session_package_id":{"type":["string","null"],"format":"uuid","description":"Balance this booking draws from. Null when the booking is not part of a package."},"tenant_metadata":{"type":"object","additionalProperties":{}},"occurrences":{"type":"array","items":{"type":"object","properties":{"recurrence_rule":{"type":"string","maxLength":1024,"description":"Rule for the occurrence’s own series, when read in booking detail."},"attendee_override":{"type":["array","null"],"items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false}},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"event_metadata":{"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":256},{"type":"number"},{"type":"boolean"},{"enum":["null"]}]},"description":"Flat, bounded opaque occurrence references owned by the integrator. No names, clinical content or credentials. Not authorization. Not projected to providers, messenger commands, inbox or public pages."},"event_details":{"type":"object","properties":{"link":{"type":["string","null"],"maxLength":800},"address":{"type":["string","null"],"minLength":1,"maxLength":1024},"description":{"type":["string","null"],"minLength":1,"maxLength":2000,"description":"Scheduling instructions visible in managed external calendars. Never include clinical or confidential notes."}},"additionalProperties":false},"conference_state":{"type":["string","null"],"enum":["pending","ready","failed"]},"root_occurrence_id":{"type":"string","format":"uuid"},"recurrence_order_local":{"type":["string","null"]},"id":{"type":"string","format":"uuid"},"booking_id":{"type":"string","format":"uuid"},"series_id":{"type":["string","null"],"format":"uuid"},"starts_at":{"type":"string"},"ends_at":{"type":"string"},"starts_local":{"type":"string"},"host_timezone":{"type":"string"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"revision":{"type":"integer"},"tz_resolution":{"type":["string","null"],"enum":["exact","shifted_forward","first_of_ambiguous"]},"dst_shift_flag":{"type":"boolean"},"rescheduled_from_id":{"type":["string","null"],"format":"uuid"},"join_url":{"type":["string","null"]},"covering_host_id":{"type":["string","null"],"format":"uuid","description":"Host delivering this occurrence when it is not the booking host. Null means the booking host."},"participant_responses":{"type":"array","items":{"type":"object","properties":{"attendee_ref":{"type":"string"},"response_status":{"type":"string","enum":["accepted","tentative","declined","needs_action"]},"response_source":{"type":"string","enum":["participant","host"]},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"responded_at":{"type":"string"},"occurrence_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["attendee_ref","response_status","version","responded_at","occurrence_revision"],"additionalProperties":false},"maxItems":50,"description":"Response for this exact revision. A host may record it on behalf of the participant or reset it to needs_action. Absence means unknown."}},"required":["id","booking_id","series_id","starts_at","ends_at","starts_local","host_timezone","status","revision","tz_resolution","dst_shift_flag","rescheduled_from_id","join_url","covering_host_id"],"additionalProperties":false},"maxItems":2048,"description":"Complete non-removed occurrence history, up to 2048 rows. Larger aggregates return 422 booking_detail_limit_exceeded without truncation; use the bounded summary and operational reconciliation."},"attendees":{"type":"array","items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false},"maxItems":50},"created_at":{"type":["string","null"]},"updated_at":{"type":["string","null"]}},"required":["id","status","event_type_id","host_id","sequence","external_ref","session_package_id","tenant_metadata","occurrences","attendees","created_at","updated_at"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/decline \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/decline', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/bookings/00000000-0000-4000-8000-000000000000/decline\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/decline', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/bookings/{bookingId}/occurrences/{id}/participant-response":{"post":{"operationId":"postV1BookingsByBookingidOccurrencesByIdParticipantResponse","summary":"Record a host decision for the primary participant","tags":["bookings"],"description":"The most recent decision determines the displayed status. A host decision preserves the original participant response.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expected_occurrence_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0},"expected_response_version":{"type":"integer","minimum":0},"response_status":{"type":"string","enum":["accepted","tentative","declined","needs_action"]}},"required":["expected_occurrence_revision","expected_response_version","response_status"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"bookingId","required":true},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"auto_reschedule":{"type":["object","null"],"properties":{"queue_position":{"type":["integer","null"],"exclusiveMinimum":true,"minimum":0},"id":{"type":"string","format":"uuid"},"occurrence_id":{"type":"string","format":"uuid"},"preferred_start":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"status":{"type":"string","enum":["waiting","applied","withdrawn","expired"]},"result_occurrence_id":{"type":["string","null"],"format":"uuid"}},"required":["queue_position","id","occurrence_id","preferred_start","status","result_occurrence_id"],"additionalProperties":false},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"reschedule_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"deletion_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"event_type_id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"sequence":{"type":"integer"},"title":{"type":["string","null"],"minLength":1,"maxLength":160,"description":"Private display title. Not copied to provider calendars or notifications."},"availability":{"type":"string","enum":["busy","free"],"description":"Busy reserves time in the occupancy ledger; free remains visible without blocking time."},"duration_minutes":{"type":["integer","null"],"minimum":1,"maximum":1440},"external_ref":{"type":["string","null"],"description":"Caller-owned id of this booking. Not a participant id."},"session_package_id":{"type":["string","null"],"format":"uuid","description":"Balance this booking draws from. Null when the booking is not part of a package."},"tenant_metadata":{"type":"object","additionalProperties":{}},"occurrences":{"type":"array","items":{"type":"object","properties":{"recurrence_rule":{"type":"string","maxLength":1024,"description":"Rule for the occurrence’s own series, when read in booking detail."},"attendee_override":{"type":["array","null"],"items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false}},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"event_metadata":{"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":256},{"type":"number"},{"type":"boolean"},{"enum":["null"]}]},"description":"Flat, bounded opaque occurrence references owned by the integrator. No names, clinical content or credentials. Not authorization. Not projected to providers, messenger commands, inbox or public pages."},"event_details":{"type":"object","properties":{"link":{"type":["string","null"],"maxLength":800},"address":{"type":["string","null"],"minLength":1,"maxLength":1024},"description":{"type":["string","null"],"minLength":1,"maxLength":2000,"description":"Scheduling instructions visible in managed external calendars. Never include clinical or confidential notes."}},"additionalProperties":false},"conference_state":{"type":["string","null"],"enum":["pending","ready","failed"]},"root_occurrence_id":{"type":"string","format":"uuid"},"recurrence_order_local":{"type":["string","null"]},"id":{"type":"string","format":"uuid"},"booking_id":{"type":"string","format":"uuid"},"series_id":{"type":["string","null"],"format":"uuid"},"starts_at":{"type":"string"},"ends_at":{"type":"string"},"starts_local":{"type":"string"},"host_timezone":{"type":"string"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"revision":{"type":"integer"},"tz_resolution":{"type":["string","null"],"enum":["exact","shifted_forward","first_of_ambiguous"]},"dst_shift_flag":{"type":"boolean"},"rescheduled_from_id":{"type":["string","null"],"format":"uuid"},"join_url":{"type":["string","null"]},"covering_host_id":{"type":["string","null"],"format":"uuid","description":"Host delivering this occurrence when it is not the booking host. Null means the booking host."},"participant_responses":{"type":"array","items":{"type":"object","properties":{"attendee_ref":{"type":"string"},"response_status":{"type":"string","enum":["accepted","tentative","declined","needs_action"]},"response_source":{"type":"string","enum":["participant","host"]},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"responded_at":{"type":"string"},"occurrence_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["attendee_ref","response_status","version","responded_at","occurrence_revision"],"additionalProperties":false},"maxItems":50,"description":"Response for this exact revision. A host may record it on behalf of the participant or reset it to needs_action. Absence means unknown."}},"required":["id","booking_id","series_id","starts_at","ends_at","starts_local","host_timezone","status","revision","tz_resolution","dst_shift_flag","rescheduled_from_id","join_url","covering_host_id"],"additionalProperties":false},"maxItems":2048,"description":"Complete non-removed occurrence history, up to 2048 rows. Larger aggregates return 422 booking_detail_limit_exceeded without truncation; use the bounded summary and operational reconciliation."},"attendees":{"type":"array","items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false},"maxItems":50},"created_at":{"type":["string","null"]},"updated_at":{"type":["string","null"]}},"required":["id","status","event_type_id","host_id","sequence","external_ref","session_package_id","tenant_metadata","occurrences","attendees","created_at","updated_at"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/occurrences/00000000-0000-4000-8000-000000000000/participant-response \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/occurrences/00000000-0000-4000-8000-000000000000/participant-response', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/bookings/00000000-0000-4000-8000-000000000000/occurrences/00000000-0000-4000-8000-000000000000/participant-response\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/occurrences/00000000-0000-4000-8000-000000000000/participant-response', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/occurrences/{id}/complete":{"post":{"operationId":"postV1OccurrencesByIdComplete","summary":"Mark an occurrence the professional has seen as completed","tags":["bookings"],"description":"Refused before the start. A worker does not guess this: the person who was in the room is the one who marks it. The booking status follows when no live occurrence remains.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."},{"schema":{"type":"string"},"in":"header","name":"if-match","required":false,"description":"Weak ETag, e.g. W/\"7\". On a booking-addressed route it carries booking.sequence; on an occurrence-addressed route it carries occurrence.revision, and the response ETag is the matching validator."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"auto_reschedule":{"type":["object","null"],"properties":{"queue_position":{"type":["integer","null"],"exclusiveMinimum":true,"minimum":0},"id":{"type":"string","format":"uuid"},"occurrence_id":{"type":"string","format":"uuid"},"preferred_start":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"status":{"type":"string","enum":["waiting","applied","withdrawn","expired"]},"result_occurrence_id":{"type":["string","null"],"format":"uuid"}},"required":["queue_position","id","occurrence_id","preferred_start","status","result_occurrence_id"],"additionalProperties":false},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"reschedule_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"deletion_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"event_type_id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"sequence":{"type":"integer"},"title":{"type":["string","null"],"minLength":1,"maxLength":160,"description":"Private display title. Not copied to provider calendars or notifications."},"availability":{"type":"string","enum":["busy","free"],"description":"Busy reserves time in the occupancy ledger; free remains visible without blocking time."},"duration_minutes":{"type":["integer","null"],"minimum":1,"maximum":1440},"external_ref":{"type":["string","null"],"description":"Caller-owned id of this booking. Not a participant id."},"session_package_id":{"type":["string","null"],"format":"uuid","description":"Balance this booking draws from. Null when the booking is not part of a package."},"tenant_metadata":{"type":"object","additionalProperties":{}},"occurrences":{"type":"array","items":{"type":"object","properties":{"recurrence_rule":{"type":"string","maxLength":1024,"description":"Rule for the occurrence’s own series, when read in booking detail."},"attendee_override":{"type":["array","null"],"items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false}},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"event_metadata":{"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":256},{"type":"number"},{"type":"boolean"},{"enum":["null"]}]},"description":"Flat, bounded opaque occurrence references owned by the integrator. No names, clinical content or credentials. Not authorization. Not projected to providers, messenger commands, inbox or public pages."},"event_details":{"type":"object","properties":{"link":{"type":["string","null"],"maxLength":800},"address":{"type":["string","null"],"minLength":1,"maxLength":1024},"description":{"type":["string","null"],"minLength":1,"maxLength":2000,"description":"Scheduling instructions visible in managed external calendars. Never include clinical or confidential notes."}},"additionalProperties":false},"conference_state":{"type":["string","null"],"enum":["pending","ready","failed"]},"root_occurrence_id":{"type":"string","format":"uuid"},"recurrence_order_local":{"type":["string","null"]},"id":{"type":"string","format":"uuid"},"booking_id":{"type":"string","format":"uuid"},"series_id":{"type":["string","null"],"format":"uuid"},"starts_at":{"type":"string"},"ends_at":{"type":"string"},"starts_local":{"type":"string"},"host_timezone":{"type":"string"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"revision":{"type":"integer"},"tz_resolution":{"type":["string","null"],"enum":["exact","shifted_forward","first_of_ambiguous"]},"dst_shift_flag":{"type":"boolean"},"rescheduled_from_id":{"type":["string","null"],"format":"uuid"},"join_url":{"type":["string","null"]},"covering_host_id":{"type":["string","null"],"format":"uuid","description":"Host delivering this occurrence when it is not the booking host. Null means the booking host."},"participant_responses":{"type":"array","items":{"type":"object","properties":{"attendee_ref":{"type":"string"},"response_status":{"type":"string","enum":["accepted","tentative","declined","needs_action"]},"response_source":{"type":"string","enum":["participant","host"]},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"responded_at":{"type":"string"},"occurrence_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["attendee_ref","response_status","version","responded_at","occurrence_revision"],"additionalProperties":false},"maxItems":50,"description":"Response for this exact revision. A host may record it on behalf of the participant or reset it to needs_action. Absence means unknown."}},"required":["id","booking_id","series_id","starts_at","ends_at","starts_local","host_timezone","status","revision","tz_resolution","dst_shift_flag","rescheduled_from_id","join_url","covering_host_id"],"additionalProperties":false},"maxItems":2048,"description":"Complete non-removed occurrence history, up to 2048 rows. Larger aggregates return 422 booking_detail_limit_exceeded without truncation; use the bounded summary and operational reconciliation."},"attendees":{"type":"array","items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false},"maxItems":50},"created_at":{"type":["string","null"]},"updated_at":{"type":["string","null"]}},"required":["id","status","event_type_id","host_id","sequence","external_ref","session_package_id","tenant_metadata","occurrences","attendees","created_at","updated_at"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000/complete \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000/complete', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/occurrences/00000000-0000-4000-8000-000000000000/complete\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000/complete', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/occurrences/{id}/no-show":{"post":{"operationId":"postV1OccurrencesByIdNoShow","summary":"Mark an occurrence the professional has seen as a no-show","tags":["bookings"],"description":"Refused before the start. A worker does not guess this: the person who was in the room is the one who marks it. The booking status follows when no live occurrence remains.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."},{"schema":{"type":"string"},"in":"header","name":"if-match","required":false,"description":"Weak ETag, e.g. W/\"7\". On a booking-addressed route it carries booking.sequence; on an occurrence-addressed route it carries occurrence.revision, and the response ETag is the matching validator."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"auto_reschedule":{"type":["object","null"],"properties":{"queue_position":{"type":["integer","null"],"exclusiveMinimum":true,"minimum":0},"id":{"type":"string","format":"uuid"},"occurrence_id":{"type":"string","format":"uuid"},"preferred_start":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"status":{"type":"string","enum":["waiting","applied","withdrawn","expired"]},"result_occurrence_id":{"type":["string","null"],"format":"uuid"}},"required":["queue_position","id","occurrence_id","preferred_start","status","result_occurrence_id"],"additionalProperties":false},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"reschedule_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"deletion_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"event_type_id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"sequence":{"type":"integer"},"title":{"type":["string","null"],"minLength":1,"maxLength":160,"description":"Private display title. Not copied to provider calendars or notifications."},"availability":{"type":"string","enum":["busy","free"],"description":"Busy reserves time in the occupancy ledger; free remains visible without blocking time."},"duration_minutes":{"type":["integer","null"],"minimum":1,"maximum":1440},"external_ref":{"type":["string","null"],"description":"Caller-owned id of this booking. Not a participant id."},"session_package_id":{"type":["string","null"],"format":"uuid","description":"Balance this booking draws from. Null when the booking is not part of a package."},"tenant_metadata":{"type":"object","additionalProperties":{}},"occurrences":{"type":"array","items":{"type":"object","properties":{"recurrence_rule":{"type":"string","maxLength":1024,"description":"Rule for the occurrence’s own series, when read in booking detail."},"attendee_override":{"type":["array","null"],"items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false}},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"event_metadata":{"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":256},{"type":"number"},{"type":"boolean"},{"enum":["null"]}]},"description":"Flat, bounded opaque occurrence references owned by the integrator. No names, clinical content or credentials. Not authorization. Not projected to providers, messenger commands, inbox or public pages."},"event_details":{"type":"object","properties":{"link":{"type":["string","null"],"maxLength":800},"address":{"type":["string","null"],"minLength":1,"maxLength":1024},"description":{"type":["string","null"],"minLength":1,"maxLength":2000,"description":"Scheduling instructions visible in managed external calendars. Never include clinical or confidential notes."}},"additionalProperties":false},"conference_state":{"type":["string","null"],"enum":["pending","ready","failed"]},"root_occurrence_id":{"type":"string","format":"uuid"},"recurrence_order_local":{"type":["string","null"]},"id":{"type":"string","format":"uuid"},"booking_id":{"type":"string","format":"uuid"},"series_id":{"type":["string","null"],"format":"uuid"},"starts_at":{"type":"string"},"ends_at":{"type":"string"},"starts_local":{"type":"string"},"host_timezone":{"type":"string"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"revision":{"type":"integer"},"tz_resolution":{"type":["string","null"],"enum":["exact","shifted_forward","first_of_ambiguous"]},"dst_shift_flag":{"type":"boolean"},"rescheduled_from_id":{"type":["string","null"],"format":"uuid"},"join_url":{"type":["string","null"]},"covering_host_id":{"type":["string","null"],"format":"uuid","description":"Host delivering this occurrence when it is not the booking host. Null means the booking host."},"participant_responses":{"type":"array","items":{"type":"object","properties":{"attendee_ref":{"type":"string"},"response_status":{"type":"string","enum":["accepted","tentative","declined","needs_action"]},"response_source":{"type":"string","enum":["participant","host"]},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"responded_at":{"type":"string"},"occurrence_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["attendee_ref","response_status","version","responded_at","occurrence_revision"],"additionalProperties":false},"maxItems":50,"description":"Response for this exact revision. A host may record it on behalf of the participant or reset it to needs_action. Absence means unknown."}},"required":["id","booking_id","series_id","starts_at","ends_at","starts_local","host_timezone","status","revision","tz_resolution","dst_shift_flag","rescheduled_from_id","join_url","covering_host_id"],"additionalProperties":false},"maxItems":2048,"description":"Complete non-removed occurrence history, up to 2048 rows. Larger aggregates return 422 booking_detail_limit_exceeded without truncation; use the bounded summary and operational reconciliation."},"attendees":{"type":"array","items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false},"maxItems":50},"created_at":{"type":["string","null"]},"updated_at":{"type":["string","null"]}},"required":["id","status","event_type_id","host_id","sequence","external_ref","session_package_id","tenant_metadata","occurrences","attendees","created_at","updated_at"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000/no-show \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000/no-show', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/occurrences/00000000-0000-4000-8000-000000000000/no-show\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000/no-show', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/hosts/{id}/health":{"get":{"operationId":"getV1HostsByIdHealth","summary":"Per-professional health view","tags":["operations"],"description":"Answers \"is this professional's calendar actually working\" in one call: sync lag, drift, channel and token state, and webhook backlog.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/health \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/health', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/hosts/00000000-0000-4000-8000-000000000000/health\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/health', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/event-types/{id}/queue":{"get":{"operationId":"getV1EventTypesByIdQueue","summary":"List waiting participants and vacancy state for an event type","tags":["bookings"],"description":"List waiting participants and vacancy state for an event type","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","pattern":"^\\d{1,15}$"},"in":"query","name":"cursor","required":false},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"occurrence_id":{"type":"string","format":"uuid"},"booking_id":{"type":"string","format":"uuid"},"participant_ref":{"type":"string"},"preferred_start":{"type":"string"},"backup_start":{"type":"string"},"status":{"type":"string","enum":["waiting","applied","withdrawn","expired"]},"result_occurrence_id":{"type":["string","null"],"format":"uuid"},"queue_position":{"type":["number","null"]},"paused":{"type":"boolean"},"available":{"type":"boolean"}},"required":["id","occurrence_id","booking_id","participant_ref","preferred_start","backup_start","status","result_occurrence_id","queue_position","paused","available"],"additionalProperties":false}},"next_cursor":{"type":["string","null"]},"policy":{"type":"object","properties":{"mode":{"type":"string","enum":["automatic","manual"]},"show_unavailable":{"type":"boolean"},"minimum_notice_minutes":{"type":"integer","minimum":0,"maximum":525600},"version":{"type":"integer","minimum":0}},"required":["mode","minimum_notice_minutes","version"],"additionalProperties":false}},"required":["data","next_cursor","policy"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/event-types/00000000-0000-4000-8000-000000000000/queue \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/event-types/00000000-0000-4000-8000-000000000000/queue', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/event-types/00000000-0000-4000-8000-000000000000/queue\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/event-types/00000000-0000-4000-8000-000000000000/queue', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/event-types/{id}/queue-policy":{"put":{"operationId":"putV1EventTypesByIdQueuePolicy","summary":"Set manual or automatic fitting and minimum lead time","tags":["configuration"],"description":"Set manual or automatic fitting and minimum lead time","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"mode":{"type":"string","enum":["automatic","manual"]},"show_unavailable":{"type":"boolean"},"minimum_notice_minutes":{"type":"integer","minimum":0,"maximum":525600},"version":{"type":"integer","minimum":0}},"required":["mode","minimum_notice_minutes","version"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"mode":{"type":"string","enum":["automatic","manual"]},"show_unavailable":{"type":"boolean"},"minimum_notice_minutes":{"type":"integer","minimum":0,"maximum":525600},"version":{"type":"integer","minimum":0}},"required":["mode","minimum_notice_minutes","version"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/event-types/00000000-0000-4000-8000-000000000000/queue-policy \\\n  --request PUT \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/event-types/00000000-0000-4000-8000-000000000000/queue-policy', {\n  method: 'PUT',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"PUT\",\n    \"/v1/event-types/00000000-0000-4000-8000-000000000000/queue-policy\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('PUT', 'https://api.calendar.anam.app/v1/event-types/00000000-0000-4000-8000-000000000000/queue-policy', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/bookings/{id}/auto-reschedule/apply":{"post":{"operationId":"postV1BookingsByIdAutoRescheduleApply","summary":"Manually fit a waiting participant, including paused queues","tags":["bookings"],"description":"Manually fit a waiting participant, including paused queues","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"request_id":{"type":"string","format":"uuid"},"reason":{"type":"string","minLength":1,"maxLength":500}},"required":["request_id"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"applied":{"type":"boolean","enum":[true]}},"required":["applied"],"additionalProperties":false}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/auto-reschedule/apply \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/auto-reschedule/apply', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/bookings/00000000-0000-4000-8000-000000000000/auto-reschedule/apply\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/auto-reschedule/apply', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/bookings/{id}/occurrences/{occurrenceId}/participants":{"put":{"operationId":"putV1BookingsByIdOccurrencesByOccurrenceidParticipants","summary":"Correct an opaque primary participant within an explicit occurrence scope","tags":["bookings"],"description":"Applies to bookings with one primary participant. Scope defaults to this; this_and_following uses immutable recurrence order across the logical booking, including series splits, and all covers the logical booking. preserve_occurrence_ids contains logical roots whose participants must remain unchanged. Policies apply to future lazy expansion. Timing and completed delivery evidence are preserved; pending delivery intents are fenced and the previous booking management capability is revoked. Uses expected_sequence and atomic idempotency.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"expected_sequence":{"type":"integer","minimum":0},"participants":{"type":"array","items":{"type":"object","properties":{"external_ref":{"type":"string","minLength":1,"maxLength":255,"description":"Opaque participant id minted by the tenant, stable for that person. Not a source-system patient id, e-mail, phone or name — those are correlatable, and this value is copied into bookings, commands and logs. The tenant keeps the mapping. A value already stored in the wrong form is replaced on operational rows by POST /v1/attendees/rekey. The access trail keeps the old ref; one append-only link says the two are the same person, and the call does not return the pair."},"role":{"type":"string","enum":["primary","guest"],"default":"primary"},"timezone":{"type":"string","description":"IANA timezone identifier"},"locale":{"type":["string","null"],"maxLength":35}},"required":["external_ref","timezone"],"additionalProperties":false},"minItems":1,"maxItems":1},"scope":{"type":"string","enum":["this","this_and_following","all"]},"preserve_occurrence_ids":{"type":"array","items":{"type":"string","format":"uuid"},"maxItems":1000}},"required":["expected_sequence","participants"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"occurrenceId","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"booking":{"type":"object","properties":{"auto_reschedule":{"type":["object","null"],"properties":{"queue_position":{"type":["integer","null"],"exclusiveMinimum":true,"minimum":0},"id":{"type":"string","format":"uuid"},"occurrence_id":{"type":"string","format":"uuid"},"preferred_start":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"status":{"type":"string","enum":["waiting","applied","withdrawn","expired"]},"result_occurrence_id":{"type":["string","null"],"format":"uuid"}},"required":["queue_position","id","occurrence_id","preferred_start","status","result_occurrence_id"],"additionalProperties":false},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"reschedule_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"deletion_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"event_type_id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"sequence":{"type":"integer"},"title":{"type":["string","null"],"minLength":1,"maxLength":160,"description":"Private display title. Not copied to provider calendars or notifications."},"availability":{"type":"string","enum":["busy","free"],"description":"Busy reserves time in the occupancy ledger; free remains visible without blocking time."},"duration_minutes":{"type":["integer","null"],"minimum":1,"maximum":1440},"external_ref":{"type":["string","null"],"description":"Caller-owned id of this booking. Not a participant id."},"session_package_id":{"type":["string","null"],"format":"uuid","description":"Balance this booking draws from. Null when the booking is not part of a package."},"tenant_metadata":{"type":"object","additionalProperties":{}},"occurrences":{"type":"array","items":{"type":"object","properties":{"recurrence_rule":{"type":"string","maxLength":1024,"description":"Rule for the occurrence’s own series, when read in booking detail."},"attendee_override":{"type":["array","null"],"items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false}},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"event_metadata":{"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":256},{"type":"number"},{"type":"boolean"},{"enum":["null"]}]},"description":"Flat, bounded opaque occurrence references owned by the integrator. No names, clinical content or credentials. Not authorization. Not projected to providers, messenger commands, inbox or public pages."},"event_details":{"type":"object","properties":{"link":{"type":["string","null"],"maxLength":800},"address":{"type":["string","null"],"minLength":1,"maxLength":1024},"description":{"type":["string","null"],"minLength":1,"maxLength":2000,"description":"Scheduling instructions visible in managed external calendars. Never include clinical or confidential notes."}},"additionalProperties":false},"conference_state":{"type":["string","null"],"enum":["pending","ready","failed"]},"root_occurrence_id":{"type":"string","format":"uuid"},"recurrence_order_local":{"type":["string","null"]},"id":{"type":"string","format":"uuid"},"booking_id":{"type":"string","format":"uuid"},"series_id":{"type":["string","null"],"format":"uuid"},"starts_at":{"type":"string"},"ends_at":{"type":"string"},"starts_local":{"type":"string"},"host_timezone":{"type":"string"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"revision":{"type":"integer"},"tz_resolution":{"type":["string","null"],"enum":["exact","shifted_forward","first_of_ambiguous"]},"dst_shift_flag":{"type":"boolean"},"rescheduled_from_id":{"type":["string","null"],"format":"uuid"},"join_url":{"type":["string","null"]},"covering_host_id":{"type":["string","null"],"format":"uuid","description":"Host delivering this occurrence when it is not the booking host. Null means the booking host."},"participant_responses":{"type":"array","items":{"type":"object","properties":{"attendee_ref":{"type":"string"},"response_status":{"type":"string","enum":["accepted","tentative","declined","needs_action"]},"response_source":{"type":"string","enum":["participant","host"]},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"responded_at":{"type":"string"},"occurrence_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["attendee_ref","response_status","version","responded_at","occurrence_revision"],"additionalProperties":false},"maxItems":50,"description":"Response for this exact revision. A host may record it on behalf of the participant or reset it to needs_action. Absence means unknown."}},"required":["id","booking_id","series_id","starts_at","ends_at","starts_local","host_timezone","status","revision","tz_resolution","dst_shift_flag","rescheduled_from_id","join_url","covering_host_id"],"additionalProperties":false},"maxItems":2048,"description":"Complete non-removed occurrence history, up to 2048 rows. Larger aggregates return 422 booking_detail_limit_exceeded without truncation; use the bounded summary and operational reconciliation."},"attendees":{"type":"array","items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false},"maxItems":50},"created_at":{"type":["string","null"]},"updated_at":{"type":["string","null"]}},"required":["id","status","event_type_id","host_id","sequence","external_ref","session_package_id","tenant_metadata","occurrences","attendees","created_at","updated_at"],"additionalProperties":false}},"required":["booking"],"additionalProperties":false}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/occurrences/00000000-0000-4000-8000-000000000000/participants \\\n  --request PUT \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/occurrences/00000000-0000-4000-8000-000000000000/participants', {\n  method: 'PUT',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"PUT\",\n    \"/v1/bookings/00000000-0000-4000-8000-000000000000/occurrences/00000000-0000-4000-8000-000000000000/participants\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('PUT', 'https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/occurrences/00000000-0000-4000-8000-000000000000/participants', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/bookings/{id}/communications":{"put":{"operationId":"putV1BookingsByIdCommunications","summary":"Replace future communication plans without resending completed messages","tags":["bookings"],"description":"Replace future communication plans without resending completed messages","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"occurrence_id":{"type":"string","format":"uuid"},"expected_sequence":{"type":"integer","minimum":0},"scope":{"type":"string","enum":["this","this_and_following","all"]},"plan":{"type":"object","properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false}},"required":["occurrence_id","expected_sequence","scope","plan"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"booking":{"type":"object","properties":{"auto_reschedule":{"type":["object","null"],"properties":{"queue_position":{"type":["integer","null"],"exclusiveMinimum":true,"minimum":0},"id":{"type":"string","format":"uuid"},"occurrence_id":{"type":"string","format":"uuid"},"preferred_start":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"status":{"type":"string","enum":["waiting","applied","withdrawn","expired"]},"result_occurrence_id":{"type":["string","null"],"format":"uuid"}},"required":["queue_position","id","occurrence_id","preferred_start","status","result_occurrence_id"],"additionalProperties":false},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"reschedule_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"deletion_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"event_type_id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"sequence":{"type":"integer"},"title":{"type":["string","null"],"minLength":1,"maxLength":160,"description":"Private display title. Not copied to provider calendars or notifications."},"availability":{"type":"string","enum":["busy","free"],"description":"Busy reserves time in the occupancy ledger; free remains visible without blocking time."},"duration_minutes":{"type":["integer","null"],"minimum":1,"maximum":1440},"external_ref":{"type":["string","null"],"description":"Caller-owned id of this booking. Not a participant id."},"session_package_id":{"type":["string","null"],"format":"uuid","description":"Balance this booking draws from. Null when the booking is not part of a package."},"tenant_metadata":{"type":"object","additionalProperties":{}},"occurrences":{"type":"array","items":{"type":"object","properties":{"recurrence_rule":{"type":"string","maxLength":1024,"description":"Rule for the occurrence’s own series, when read in booking detail."},"attendee_override":{"type":["array","null"],"items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false}},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"event_metadata":{"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":256},{"type":"number"},{"type":"boolean"},{"enum":["null"]}]},"description":"Flat, bounded opaque occurrence references owned by the integrator. No names, clinical content or credentials. Not authorization. Not projected to providers, messenger commands, inbox or public pages."},"event_details":{"type":"object","properties":{"link":{"type":["string","null"],"maxLength":800},"address":{"type":["string","null"],"minLength":1,"maxLength":1024},"description":{"type":["string","null"],"minLength":1,"maxLength":2000,"description":"Scheduling instructions visible in managed external calendars. Never include clinical or confidential notes."}},"additionalProperties":false},"conference_state":{"type":["string","null"],"enum":["pending","ready","failed"]},"root_occurrence_id":{"type":"string","format":"uuid"},"recurrence_order_local":{"type":["string","null"]},"id":{"type":"string","format":"uuid"},"booking_id":{"type":"string","format":"uuid"},"series_id":{"type":["string","null"],"format":"uuid"},"starts_at":{"type":"string"},"ends_at":{"type":"string"},"starts_local":{"type":"string"},"host_timezone":{"type":"string"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"revision":{"type":"integer"},"tz_resolution":{"type":["string","null"],"enum":["exact","shifted_forward","first_of_ambiguous"]},"dst_shift_flag":{"type":"boolean"},"rescheduled_from_id":{"type":["string","null"],"format":"uuid"},"join_url":{"type":["string","null"]},"covering_host_id":{"type":["string","null"],"format":"uuid","description":"Host delivering this occurrence when it is not the booking host. Null means the booking host."},"participant_responses":{"type":"array","items":{"type":"object","properties":{"attendee_ref":{"type":"string"},"response_status":{"type":"string","enum":["accepted","tentative","declined","needs_action"]},"response_source":{"type":"string","enum":["participant","host"]},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"responded_at":{"type":"string"},"occurrence_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["attendee_ref","response_status","version","responded_at","occurrence_revision"],"additionalProperties":false},"maxItems":50,"description":"Response for this exact revision. A host may record it on behalf of the participant or reset it to needs_action. Absence means unknown."}},"required":["id","booking_id","series_id","starts_at","ends_at","starts_local","host_timezone","status","revision","tz_resolution","dst_shift_flag","rescheduled_from_id","join_url","covering_host_id"],"additionalProperties":false},"maxItems":2048,"description":"Complete non-removed occurrence history, up to 2048 rows. Larger aggregates return 422 booking_detail_limit_exceeded without truncation; use the bounded summary and operational reconciliation."},"attendees":{"type":"array","items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false},"maxItems":50},"created_at":{"type":["string","null"]},"updated_at":{"type":["string","null"]}},"required":["id","status","event_type_id","host_id","sequence","external_ref","session_package_id","tenant_metadata","occurrences","attendees","created_at","updated_at"],"additionalProperties":false}},"required":["booking"],"additionalProperties":false}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/communications \\\n  --request PUT \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/communications', {\n  method: 'PUT',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"PUT\",\n    \"/v1/bookings/00000000-0000-4000-8000-000000000000/communications\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('PUT', 'https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/communications', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/bookings/summary":{"get":{"operationId":"getV1BookingsSummary","summary":"List bounded booking metadata in a time window","tags":["bookings"],"description":"Tenant required. At most 50 bookings and 10 occurrences per booking by default within a maximum 62-day window. Callers may request up to 64 occurrences per booking and an optional total occurrence budget per page. occurrence_count and occurrences_truncated are explicit; fetch the authorized detail separately. This is a projection, not a second canonical calendar.","parameters":[{"schema":{"type":"string","format":"date-time"},"in":"query","name":"from","required":true,"description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"to","required":true,"description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"host_id","required":false},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":25},"in":"query","name":"limit","required":false},{"schema":{"type":"string","maxLength":512},"in":"query","name":"cursor","required":false},{"schema":{"type":"integer","minimum":1,"maximum":64,"default":10},"in":"query","name":"occurrence_limit","required":false},{"schema":{"type":"integer","minimum":64,"maximum":500},"in":"query","name":"occurrence_budget","required":false},{"schema":{"type":"string","enum":["true","false"],"default":"false"},"in":"query","name":"include_attendee_refs","required":false,"description":"Opt-in lightweight opaque references for an authorized integration to resolve its own contact directory. Does not include attendee payloads."},{"schema":{"type":"string","enum":["true","false"],"default":"false"},"in":"query","name":"include_notification_cursor","required":false,"description":"Backend-only opt-in host feed checkpoint."},{"schema":{"type":"string","enum":["true","false"],"default":"false"},"in":"query","name":"include_external_ref","required":false,"description":"Backend-only opt-in opaque booking reference for an integration to validate its publication receipt. Browser grants are refused. No source document or payload is returned."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"reschedule_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"deletion_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"event_type_id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"sequence":{"type":"integer"},"title":{"type":["string","null"],"minLength":1,"maxLength":160,"description":"Private display title. Not copied to provider calendars or notifications."},"availability":{"type":"string","enum":["busy","free"],"description":"Busy reserves time in the occupancy ledger; free remains visible without blocking time."},"duration_minutes":{"type":["integer","null"],"minimum":1,"maximum":1440},"attendee_refs":{"type":"array","items":{"type":"string","maxLength":255},"maxItems":50},"external_ref":{"type":["string","null"],"maxLength":255},"occurrences":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"starts_at":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"ends_at":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"starts_local":{"type":"string"},"host_timezone":{"type":"string"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"revision":{"type":"integer"},"rescheduled_from_id":{"type":["string","null"],"format":"uuid"},"rescheduled_away":{"type":"boolean","description":"This occurrence was superseded, even if the successor is outside this result."},"root_occurrence_id":{"type":"string","format":"uuid"},"recurrence_order_local":{"type":["string","null"]},"series_id":{"type":["string","null"],"format":"uuid"},"participant_response_status":{"type":"string","enum":["accepted","tentative","declined","needs_action"]}},"required":["id","starts_at","ends_at","starts_local","host_timezone","status","revision","rescheduled_from_id","rescheduled_away"],"additionalProperties":false},"maxItems":64},"occurrence_count":{"type":"integer","minimum":0},"occurrences_truncated":{"type":"boolean"}},"required":["reschedule_scopes","id","host_id","event_type_id","status","sequence","title","availability","duration_minutes","occurrences","occurrence_count","occurrences_truncated"],"additionalProperties":false},"maxItems":50},"notification_cursor":{"type":"string","maxLength":512,"description":"Opaque host feed position covered by this snapshot."},"page":{"type":"object","properties":{"next_cursor":{"type":["string","null"]},"has_more":{"type":"boolean"},"limit":{"type":"integer"}},"required":["next_cursor","has_more","limit"],"additionalProperties":false}},"required":["data","page"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/bookings/summary \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/bookings/summary', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/bookings/summary\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/bookings/summary', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/occurrences/projections":{"post":{"operationId":"postV1OccurrencesProjections","summary":"Resolve lightweight current metadata for bounded exact occurrence identities","tags":["bookings"],"description":"No recurrence expansion, attendee payload or history. Indexed logical root/current pointers follow aliases without a history-depth truncation. Whole batch fails if any identity is inaccessible or inconsistent.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"occurrence_ids":{"type":"array","items":{"type":"string","format":"uuid"},"minItems":1,"maxItems":200}},"required":["occurrence_ids"],"additionalProperties":false}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"origin_occurrence_id":{"type":"string","format":"uuid"},"root_occurrence_id":{"type":"string","format":"uuid"},"recurrence_order_local":{"type":["string","null"]},"series_id":{"type":["string","null"],"format":"uuid"},"occurrence_id":{"type":"string","format":"uuid"},"booking_id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"event_type_id":{"type":"string","format":"uuid"},"starts_at":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"ends_at":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"starts_local":{"type":"string"},"host_timezone":{"type":"string"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"revision":{"type":"integer","exclusiveMinimum":true,"minimum":0},"booking_sequence":{"type":"integer","minimum":0},"booking_etag":{"type":"string"},"external_reference":{"type":["object","null"],"properties":{"namespace":{"type":"string","pattern":"^[a-zA-Z0-9_.-]{1,64}$"},"value":{"type":"string","minLength":1,"maxLength":255}},"required":["namespace","value"],"additionalProperties":false},"event_location":{"type":"object","properties":{"link":{"type":["string","null"]},"address":{"type":["string","null"]},"join_url":{"type":["string","null"]}},"required":["join_url"],"additionalProperties":false}},"required":["origin_occurrence_id","root_occurrence_id","recurrence_order_local","series_id","occurrence_id","booking_id","host_id","event_type_id","starts_at","ends_at","starts_local","host_timezone","status","revision","booking_sequence","booking_etag","external_reference"],"additionalProperties":false},"maxItems":200}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/occurrences/projections \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/occurrences/projections', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/occurrences/projections\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/occurrences/projections', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/occurrences/external-references":{"post":{"operationId":"postV1OccurrencesExternalReferences","summary":"Bind immutable opaque integrator references to logical occurrence roots","tags":["bookings"],"description":"A reference is a locator, never a credential. Alias lookup resolves to its logical root. Compatible repeat is a no-op; incompatible reuse conflicts. No schedule revision/provider write/invitation. Current resource authority is rechecked before receipt replay.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"namespace":{"type":"string","pattern":"^[a-zA-Z0-9_.-]{1,64}$"},"references":{"type":"array","items":{"type":"object","properties":{"occurrence_id":{"type":"string","format":"uuid"},"external_ref":{"type":"string","minLength":1,"maxLength":255}},"required":["occurrence_id","external_ref"],"additionalProperties":false},"minItems":1,"maxItems":200}},"required":["namespace","references"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","minLength":1,"maxLength":255},"in":"header","name":"idempotency-key","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"origin_occurrence_id":{"type":"string","format":"uuid"},"root_occurrence_id":{"type":"string","format":"uuid"},"booking_id":{"type":"string","format":"uuid"},"external_ref":{"type":"string","minLength":1,"maxLength":255}},"required":["origin_occurrence_id","root_occurrence_id","booking_id","external_ref"],"additionalProperties":false},"maxItems":200}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/occurrences/external-references \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/occurrences/external-references', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/occurrences/external-references\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/occurrences/external-references', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/occurrences/referenced":{"get":{"operationId":"getV1OccurrencesReferenced","summary":"Page current materialized occurrences carrying an opaque integrator namespace","tags":["bookings"],"description":"Indexed root/current joins and live keyset ordering by instant/reference. No recurrence expansion or history scan per root; response limit100. Optional interval bounds compare UTC instants, not ISO text.","parameters":[{"schema":{"type":"string","pattern":"^[a-zA-Z0-9_.-]{1,64}$"},"in":"query","name":"namespace","required":true},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"from","required":false,"description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"to","required":false,"description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":50},"in":"query","name":"limit","required":false},{"schema":{"type":"string","enum":["asc","desc"],"default":"asc"},"in":"query","name":"direction","required":false},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"after_date","required":false,"description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},{"schema":{"type":"string","minLength":1,"maxLength":255},"in":"query","name":"after_ref","required":false},{"schema":{"type":"string","enum":["true","false"],"default":"false"},"in":"query","name":"exclude_cancelled","required":false},{"schema":{"type":"string","maxLength":1024},"in":"query","name":"cursor","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"origin_occurrence_id":{"type":"string","format":"uuid"},"root_occurrence_id":{"type":"string","format":"uuid"},"recurrence_order_local":{"type":["string","null"]},"series_id":{"type":["string","null"],"format":"uuid"},"occurrence_id":{"type":"string","format":"uuid"},"booking_id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"event_type_id":{"type":"string","format":"uuid"},"starts_at":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"ends_at":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"starts_local":{"type":"string"},"host_timezone":{"type":"string"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"revision":{"type":"integer","exclusiveMinimum":true,"minimum":0},"booking_sequence":{"type":"integer","minimum":0},"booking_etag":{"type":"string"},"external_reference":{"type":["object","null"],"properties":{"namespace":{"type":"string","pattern":"^[a-zA-Z0-9_.-]{1,64}$"},"value":{"type":"string","minLength":1,"maxLength":255}},"required":["namespace","value"],"additionalProperties":false}},"required":["origin_occurrence_id","root_occurrence_id","recurrence_order_local","series_id","occurrence_id","booking_id","host_id","event_type_id","starts_at","ends_at","starts_local","host_timezone","status","revision","booking_sequence","booking_etag","external_reference"],"additionalProperties":false},"maxItems":100},"total_references":{"type":"integer","minimum":0},"page":{"type":"object","properties":{"next_cursor":{"type":["string","null"]},"has_more":{"type":"boolean"},"limit":{"type":"integer"}},"required":["next_cursor","has_more","limit"],"additionalProperties":false},"ordering":{"type":"string","enum":["live-keyset-v1"]}},"required":["data","total_references","page","ordering"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/occurrences/referenced \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/occurrences/referenced', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/occurrences/referenced\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/occurrences/referenced', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/bookings/{id}/removal-plan":{"get":{"operationId":"getV1BookingsByIdRemovalPlan","summary":"Preview the exact logical removal targets without changing state","tags":["bookings"],"description":"Backend booking:write only. Scope is explicit. this_and_following follows immutable logical recurrence order, including individually moved occurrences and verified series splits. The target ids include reschedule aliases and tombstoned history. The plan hash binds the exact target set and recurrence boundaries; send it with the removal mutation. Unknown historical split identities return 422 requiring reconciliation. No clinical data or external effects are read or sent.","parameters":[{"schema":{"type":"string","enum":["this","this_and_following","all"]},"in":"query","name":"scope","required":true},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"occurrence_id","required":false},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"booking_id":{"type":"string","format":"uuid"},"scope":{"type":"string","enum":["this","this_and_following","all"]},"occurrence_id":{"type":"string","format":"uuid"},"expected_sequence":{"type":"integer","minimum":0,"maximum":9007199254740991,"exclusiveMinimum":true},"target_occurrence_ids":{"type":"array","items":{"type":"string","format":"uuid"},"maxItems":10000},"root_occurrence_ids":{"type":"array","items":{"type":"string","format":"uuid"},"maxItems":10000},"booking_will_be_removed":{"type":"boolean"},"plan_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["booking_id","scope","expected_sequence","target_occurrence_ids","root_occurrence_ids","booking_will_be_removed","plan_hash"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/removal-plan \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/removal-plan', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/bookings/00000000-0000-4000-8000-000000000000/removal-plan\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/removal-plan', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/bookings/{id}/remove":{"post":{"operationId":"postV1BookingsByIdRemove","summary":"Remove one occurrence, this and following, or the entire logical booking","tags":["bookings"],"description":"Backend booking:write only, required Idempotency-Key and current sequence. Unlike cancellation, removal hides the resource from active reads, including cancelled/completed/imported facts, while retaining opaque tombstones and audit. An occurrence selector removes its entire reschedule lineage. Without it the whole booking stops materializing. Removal is bounded to 10000 stored occurrence/history rows; an oversized operation returns 422 without partial deletion. No invitations or attendee notices are emitted; queued reminders receive cancel-by-source only. Existing provider projections receive durable cleanup intent; external cleanup is eventual. Imported read-only events may be removed, and their import source tombstone prevents replay resurrection. Consumer-specific linked resource deletion is the integrator responsibility.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"occurrence_id":{"type":"string","format":"uuid"},"scope":{"type":"string","enum":["this","this_and_following","all"]},"plan_hash":{"type":"string","pattern":"^[a-f0-9]{64}$"},"expected_sequence":{"type":"integer","minimum":0,"maximum":9007199254740991,"exclusiveMinimum":true}},"required":["expected_sequence"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","minLength":1,"maxLength":255},"in":"header","name":"idempotency-key","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"booking_id":{"type":"string","format":"uuid"},"removed_occurrence_ids":{"type":"array","items":{"type":"string","format":"uuid"},"maxItems":10000},"booking_removed":{"type":"boolean"},"sequence":{"type":"integer","minimum":0},"effects":{"type":"string","enum":["none","cleanup_only"]},"notification_event_id":{"type":"string","format":"uuid"},"scope":{"type":"string","enum":["this","this_and_following","all"]}},"required":["booking_id","removed_occurrence_ids","booking_removed","sequence","effects"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/remove \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/remove', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/bookings/00000000-0000-4000-8000-000000000000/remove\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/bookings/00000000-0000-4000-8000-000000000000/remove', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/occurrences/{id}":{"patch":{"operationId":"patchV1OccurrencesById","summary":"Edit a recurring occurrence, with an explicit scope","tags":["series"],"description":"The new time is given as a wall clock in the host timezone, not as an instant: a recurring appointment that moves to 16:00 means 16:00 every week, whatever the offset is that month. Pending-approval bookings accept only an individual move, preserving its expiring hold; broad edits return 409 pending_approval_series_edit_unsupported until approval. Package-backed bookings also accept only individual moves, preserving the existing package draw; broad edits return 409 package_series_edit_unsupported because atomic draw reconciliation is not implemented. If this booking contains logically removed occurrences, all and this_and_following fail with 422 validation_failed and code_detail=series_removal_reconciliation_required. Individual surviving occurrence edits remain supported; broad edits never recreate removed dates under new identities.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scope":{"type":"string","enum":["this","this_and_following","all"],"description":"Required. `this` moves one occurrence and detaches it from the pattern; `this_and_following` cuts the series and starts a new one; `all` rewrites the pattern, leaving past and individually-overridden occurrences alone. Broad reconciliation reads at most 366 current leaves; overflow returns 422 series_reconciliation_limit_exceeded before changing the pattern or occupancy."},"allow_google_conflict":{"type":"boolean","enum":[true],"description":"Trusted Google busy override for this edit."},"starts_local":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[ T]\\d{2}:\\d{2}(:\\d{2})?$","description":"Wall clock in the host timezone, e.g. 2026-10-08 16:00. Not an instant."},"rrule":{"type":"string","minLength":3},"expected_booking_sequence":{"type":"integer","exclusiveMinimum":true,"minimum":0},"reason":{"type":["string","null"],"maxLength":500},"justification":{"type":"string","minLength":1,"maxLength":500}},"required":["scope"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."},{"schema":{"type":"string"},"in":"header","name":"if-match","required":false,"description":"Weak ETag, e.g. W/\"7\". On a booking-addressed route it carries booking.sequence; on an occurrence-addressed route it carries occurrence.revision, and the response ETag is the matching validator."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"booking":{"type":"object","properties":{"auto_reschedule":{"type":["object","null"],"properties":{"queue_position":{"type":["integer","null"],"exclusiveMinimum":true,"minimum":0},"id":{"type":"string","format":"uuid"},"occurrence_id":{"type":"string","format":"uuid"},"preferred_start":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"status":{"type":"string","enum":["waiting","applied","withdrawn","expired"]},"result_occurrence_id":{"type":["string","null"],"format":"uuid"}},"required":["queue_position","id","occurrence_id","preferred_start","status","result_occurrence_id"],"additionalProperties":false},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"reschedule_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"deletion_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"event_type_id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"sequence":{"type":"integer"},"title":{"type":["string","null"],"minLength":1,"maxLength":160,"description":"Private display title. Not copied to provider calendars or notifications."},"availability":{"type":"string","enum":["busy","free"],"description":"Busy reserves time in the occupancy ledger; free remains visible without blocking time."},"duration_minutes":{"type":["integer","null"],"minimum":1,"maximum":1440},"external_ref":{"type":["string","null"],"description":"Caller-owned id of this booking. Not a participant id."},"session_package_id":{"type":["string","null"],"format":"uuid","description":"Balance this booking draws from. Null when the booking is not part of a package."},"tenant_metadata":{"type":"object","additionalProperties":{}},"occurrences":{"type":"array","items":{"type":"object","properties":{"recurrence_rule":{"type":"string","maxLength":1024,"description":"Rule for the occurrence’s own series, when read in booking detail."},"attendee_override":{"type":["array","null"],"items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false}},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"event_metadata":{"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":256},{"type":"number"},{"type":"boolean"},{"enum":["null"]}]},"description":"Flat, bounded opaque occurrence references owned by the integrator. No names, clinical content or credentials. Not authorization. Not projected to providers, messenger commands, inbox or public pages."},"event_details":{"type":"object","properties":{"link":{"type":["string","null"],"maxLength":800},"address":{"type":["string","null"],"minLength":1,"maxLength":1024},"description":{"type":["string","null"],"minLength":1,"maxLength":2000,"description":"Scheduling instructions visible in managed external calendars. Never include clinical or confidential notes."}},"additionalProperties":false},"conference_state":{"type":["string","null"],"enum":["pending","ready","failed"]},"root_occurrence_id":{"type":"string","format":"uuid"},"recurrence_order_local":{"type":["string","null"]},"id":{"type":"string","format":"uuid"},"booking_id":{"type":"string","format":"uuid"},"series_id":{"type":["string","null"],"format":"uuid"},"starts_at":{"type":"string"},"ends_at":{"type":"string"},"starts_local":{"type":"string"},"host_timezone":{"type":"string"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"revision":{"type":"integer"},"tz_resolution":{"type":["string","null"],"enum":["exact","shifted_forward","first_of_ambiguous"]},"dst_shift_flag":{"type":"boolean"},"rescheduled_from_id":{"type":["string","null"],"format":"uuid"},"join_url":{"type":["string","null"]},"covering_host_id":{"type":["string","null"],"format":"uuid","description":"Host delivering this occurrence when it is not the booking host. Null means the booking host."},"participant_responses":{"type":"array","items":{"type":"object","properties":{"attendee_ref":{"type":"string"},"response_status":{"type":"string","enum":["accepted","tentative","declined","needs_action"]},"response_source":{"type":"string","enum":["participant","host"]},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"responded_at":{"type":"string"},"occurrence_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["attendee_ref","response_status","version","responded_at","occurrence_revision"],"additionalProperties":false},"maxItems":50,"description":"Response for this exact revision. A host may record it on behalf of the participant or reset it to needs_action. Absence means unknown."}},"required":["id","booking_id","series_id","starts_at","ends_at","starts_local","host_timezone","status","revision","tz_resolution","dst_shift_flag","rescheduled_from_id","join_url","covering_host_id"],"additionalProperties":false},"maxItems":2048,"description":"Complete non-removed occurrence history, up to 2048 rows. Larger aggregates return 422 booking_detail_limit_exceeded without truncation; use the bounded summary and operational reconciliation."},"attendees":{"type":"array","items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false},"maxItems":50},"created_at":{"type":["string","null"]},"updated_at":{"type":["string","null"]}},"required":["id","status","event_type_id","host_id","sequence","external_ref","session_package_id","tenant_metadata","occurrences","attendees","created_at","updated_at"],"additionalProperties":false},"scope":{"type":"string"},"affected_occurrence_ids":{"type":"array","items":{"type":"string","format":"uuid"}},"skipped":{"type":"array","items":{"type":"object","properties":{"starts_local":{"type":"string"},"reason":{"type":"string"}},"required":["starts_local","reason"],"additionalProperties":false}},"new_series_id":{"type":["string","null"],"format":"uuid"}},"required":["booking","scope","affected_occurrence_ids","skipped","new_series_id"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000 \\\n  --request PATCH \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000', {\n  method: 'PATCH',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"PATCH\",\n    \"/v1/occurrences/00000000-0000-4000-8000-000000000000\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('PATCH', 'https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]},"delete":{"operationId":"deleteV1OccurrencesById","summary":"Cancel planned dates of the selected recurrence series, with an explicit scope","tags":["series"],"description":"Cancellation retains occurrence history. The current recurrence series contains the addressed occurrence; a this_and_following edit creates a distinct series under the same logical booking. Other parts created by a split keep their planning and occupancy. Use POST /v1/bookings/:id/cancel to cancel the entire logical booking, including all its parts. Completed and no-show history remains unchanged. Cancellation effects are persisted only for newly cancelled occurrences; replay of an exact Idempotency-Key returns the original receipt.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","enum":["this","this_and_following","all"]},"in":"query","name":"scope","required":true,"description":"Required. this cancels only the addressed planned occurrence. this_and_following ends its current recurrence series at that date. all closes that entire recurrence series, including its future horizon, while preserving other series created by a split."},{"schema":{"type":"string","maxLength":500},"in":"query","name":"reason","required":false},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."},{"schema":{"type":"string"},"in":"header","name":"if-match","required":false,"description":"Weak ETag, e.g. W/\"7\". On a booking-addressed route it carries booking.sequence; on an occurrence-addressed route it carries occurrence.revision, and the response ETag is the matching validator."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"booking":{"type":"object","properties":{"auto_reschedule":{"type":["object","null"],"properties":{"queue_position":{"type":["integer","null"],"exclusiveMinimum":true,"minimum":0},"id":{"type":"string","format":"uuid"},"occurrence_id":{"type":"string","format":"uuid"},"preferred_start":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"status":{"type":"string","enum":["waiting","applied","withdrawn","expired"]},"result_occurrence_id":{"type":["string","null"],"format":"uuid"}},"required":["queue_position","id","occurrence_id","preferred_start","status","result_occurrence_id"],"additionalProperties":false},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"reschedule_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"deletion_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"event_type_id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"sequence":{"type":"integer"},"title":{"type":["string","null"],"minLength":1,"maxLength":160,"description":"Private display title. Not copied to provider calendars or notifications."},"availability":{"type":"string","enum":["busy","free"],"description":"Busy reserves time in the occupancy ledger; free remains visible without blocking time."},"duration_minutes":{"type":["integer","null"],"minimum":1,"maximum":1440},"external_ref":{"type":["string","null"],"description":"Caller-owned id of this booking. Not a participant id."},"session_package_id":{"type":["string","null"],"format":"uuid","description":"Balance this booking draws from. Null when the booking is not part of a package."},"tenant_metadata":{"type":"object","additionalProperties":{}},"occurrences":{"type":"array","items":{"type":"object","properties":{"recurrence_rule":{"type":"string","maxLength":1024,"description":"Rule for the occurrence’s own series, when read in booking detail."},"attendee_override":{"type":["array","null"],"items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false}},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"event_metadata":{"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":256},{"type":"number"},{"type":"boolean"},{"enum":["null"]}]},"description":"Flat, bounded opaque occurrence references owned by the integrator. No names, clinical content or credentials. Not authorization. Not projected to providers, messenger commands, inbox or public pages."},"event_details":{"type":"object","properties":{"link":{"type":["string","null"],"maxLength":800},"address":{"type":["string","null"],"minLength":1,"maxLength":1024},"description":{"type":["string","null"],"minLength":1,"maxLength":2000,"description":"Scheduling instructions visible in managed external calendars. Never include clinical or confidential notes."}},"additionalProperties":false},"conference_state":{"type":["string","null"],"enum":["pending","ready","failed"]},"root_occurrence_id":{"type":"string","format":"uuid"},"recurrence_order_local":{"type":["string","null"]},"id":{"type":"string","format":"uuid"},"booking_id":{"type":"string","format":"uuid"},"series_id":{"type":["string","null"],"format":"uuid"},"starts_at":{"type":"string"},"ends_at":{"type":"string"},"starts_local":{"type":"string"},"host_timezone":{"type":"string"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"revision":{"type":"integer"},"tz_resolution":{"type":["string","null"],"enum":["exact","shifted_forward","first_of_ambiguous"]},"dst_shift_flag":{"type":"boolean"},"rescheduled_from_id":{"type":["string","null"],"format":"uuid"},"join_url":{"type":["string","null"]},"covering_host_id":{"type":["string","null"],"format":"uuid","description":"Host delivering this occurrence when it is not the booking host. Null means the booking host."},"participant_responses":{"type":"array","items":{"type":"object","properties":{"attendee_ref":{"type":"string"},"response_status":{"type":"string","enum":["accepted","tentative","declined","needs_action"]},"response_source":{"type":"string","enum":["participant","host"]},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"responded_at":{"type":"string"},"occurrence_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["attendee_ref","response_status","version","responded_at","occurrence_revision"],"additionalProperties":false},"maxItems":50,"description":"Response for this exact revision. A host may record it on behalf of the participant or reset it to needs_action. Absence means unknown."}},"required":["id","booking_id","series_id","starts_at","ends_at","starts_local","host_timezone","status","revision","tz_resolution","dst_shift_flag","rescheduled_from_id","join_url","covering_host_id"],"additionalProperties":false},"maxItems":2048,"description":"Complete non-removed occurrence history, up to 2048 rows. Larger aggregates return 422 booking_detail_limit_exceeded without truncation; use the bounded summary and operational reconciliation."},"attendees":{"type":"array","items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false},"maxItems":50},"created_at":{"type":["string","null"]},"updated_at":{"type":["string","null"]}},"required":["id","status","event_type_id","host_id","sequence","external_ref","session_package_id","tenant_metadata","occurrences","attendees","created_at","updated_at"],"additionalProperties":false},"scope":{"type":"string"},"affected_occurrence_ids":{"type":"array","items":{"type":"string","format":"uuid"}},"skipped":{"type":"array","items":{"type":"object","properties":{"starts_local":{"type":"string"},"reason":{"type":"string"}},"required":["starts_local","reason"],"additionalProperties":false}},"new_series_id":{"type":["string","null"],"format":"uuid"}},"required":["booking","scope","affected_occurrence_ids","skipped","new_series_id"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000 \\\n  --request DELETE \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000', {\n  method: 'DELETE',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"DELETE\",\n    \"/v1/occurrences/00000000-0000-4000-8000-000000000000\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('DELETE', 'https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/occurrences/{id}/cancel":{"post":{"operationId":"postV1OccurrencesByIdCancel","summary":"Cancel dates of a recurrence with an optional private justification","tags":["series"],"description":"Cancel dates of a recurrence with an optional private justification","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"scope":{"type":"string","enum":["this","this_and_following","all"],"description":"Required. `this` moves one occurrence and detaches it from the pattern; `this_and_following` cuts the series and starts a new one; `all` rewrites the pattern, leaving past and individually-overridden occurrences alone. Broad reconciliation reads at most 366 current leaves; overflow returns 422 series_reconciliation_limit_exceeded before changing the pattern or occupancy."},"justification":{"type":"string","minLength":1,"maxLength":500}},"required":["scope"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."},{"schema":{"type":"string"},"in":"header","name":"if-match","required":false,"description":"Weak ETag, e.g. W/\"7\". On a booking-addressed route it carries booking.sequence; on an occurrence-addressed route it carries occurrence.revision, and the response ETag is the matching validator."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"booking":{"type":"object","properties":{"auto_reschedule":{"type":["object","null"],"properties":{"queue_position":{"type":["integer","null"],"exclusiveMinimum":true,"minimum":0},"id":{"type":"string","format":"uuid"},"occurrence_id":{"type":"string","format":"uuid"},"preferred_start":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"status":{"type":"string","enum":["waiting","applied","withdrawn","expired"]},"result_occurrence_id":{"type":["string","null"],"format":"uuid"}},"required":["queue_position","id","occurrence_id","preferred_start","status","result_occurrence_id"],"additionalProperties":false},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"reschedule_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"deletion_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"event_type_id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"sequence":{"type":"integer"},"title":{"type":["string","null"],"minLength":1,"maxLength":160,"description":"Private display title. Not copied to provider calendars or notifications."},"availability":{"type":"string","enum":["busy","free"],"description":"Busy reserves time in the occupancy ledger; free remains visible without blocking time."},"duration_minutes":{"type":["integer","null"],"minimum":1,"maximum":1440},"external_ref":{"type":["string","null"],"description":"Caller-owned id of this booking. Not a participant id."},"session_package_id":{"type":["string","null"],"format":"uuid","description":"Balance this booking draws from. Null when the booking is not part of a package."},"tenant_metadata":{"type":"object","additionalProperties":{}},"occurrences":{"type":"array","items":{"type":"object","properties":{"recurrence_rule":{"type":"string","maxLength":1024,"description":"Rule for the occurrence’s own series, when read in booking detail."},"attendee_override":{"type":["array","null"],"items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false}},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"event_metadata":{"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":256},{"type":"number"},{"type":"boolean"},{"enum":["null"]}]},"description":"Flat, bounded opaque occurrence references owned by the integrator. No names, clinical content or credentials. Not authorization. Not projected to providers, messenger commands, inbox or public pages."},"event_details":{"type":"object","properties":{"link":{"type":["string","null"],"maxLength":800},"address":{"type":["string","null"],"minLength":1,"maxLength":1024},"description":{"type":["string","null"],"minLength":1,"maxLength":2000,"description":"Scheduling instructions visible in managed external calendars. Never include clinical or confidential notes."}},"additionalProperties":false},"conference_state":{"type":["string","null"],"enum":["pending","ready","failed"]},"root_occurrence_id":{"type":"string","format":"uuid"},"recurrence_order_local":{"type":["string","null"]},"id":{"type":"string","format":"uuid"},"booking_id":{"type":"string","format":"uuid"},"series_id":{"type":["string","null"],"format":"uuid"},"starts_at":{"type":"string"},"ends_at":{"type":"string"},"starts_local":{"type":"string"},"host_timezone":{"type":"string"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"revision":{"type":"integer"},"tz_resolution":{"type":["string","null"],"enum":["exact","shifted_forward","first_of_ambiguous"]},"dst_shift_flag":{"type":"boolean"},"rescheduled_from_id":{"type":["string","null"],"format":"uuid"},"join_url":{"type":["string","null"]},"covering_host_id":{"type":["string","null"],"format":"uuid","description":"Host delivering this occurrence when it is not the booking host. Null means the booking host."},"participant_responses":{"type":"array","items":{"type":"object","properties":{"attendee_ref":{"type":"string"},"response_status":{"type":"string","enum":["accepted","tentative","declined","needs_action"]},"response_source":{"type":"string","enum":["participant","host"]},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"responded_at":{"type":"string"},"occurrence_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["attendee_ref","response_status","version","responded_at","occurrence_revision"],"additionalProperties":false},"maxItems":50,"description":"Response for this exact revision. A host may record it on behalf of the participant or reset it to needs_action. Absence means unknown."}},"required":["id","booking_id","series_id","starts_at","ends_at","starts_local","host_timezone","status","revision","tz_resolution","dst_shift_flag","rescheduled_from_id","join_url","covering_host_id"],"additionalProperties":false},"maxItems":2048,"description":"Complete non-removed occurrence history, up to 2048 rows. Larger aggregates return 422 booking_detail_limit_exceeded without truncation; use the bounded summary and operational reconciliation."},"attendees":{"type":"array","items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false},"maxItems":50},"created_at":{"type":["string","null"]},"updated_at":{"type":["string","null"]}},"required":["id","status","event_type_id","host_id","sequence","external_ref","session_package_id","tenant_metadata","occurrences","attendees","created_at","updated_at"],"additionalProperties":false},"scope":{"type":"string"},"affected_occurrence_ids":{"type":"array","items":{"type":"string","format":"uuid"}},"skipped":{"type":"array","items":{"type":"object","properties":{"starts_local":{"type":"string"},"reason":{"type":"string"}},"required":["starts_local","reason"],"additionalProperties":false}},"new_series_id":{"type":["string","null"],"format":"uuid"}},"required":["booking","scope","affected_occurrence_ids","skipped","new_series_id"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000/cancel \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000/cancel', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/occurrences/00000000-0000-4000-8000-000000000000/cancel\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000/cancel', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/series/{id}/materialize":{"post":{"operationId":"postV1SeriesByIdMaterialize","summary":"Extend an open-ended series to the rolling horizon now","tags":["series"],"description":"The worker does this on a timer. The endpoint exists for operators who need it immediately, and is idempotent: running it twice creates nothing the first run already created.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"series_id":{"type":"string","format":"uuid"},"created":{"type":"array","items":{"type":"string","format":"uuid"}},"skipped":{"type":"array","items":{"type":"string"}},"horizon_local_date":{"type":"string"},"completed":{"type":"boolean"}},"required":["series_id","created","skipped","horizon_local_date","completed"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/series/00000000-0000-4000-8000-000000000000/materialize \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/series/00000000-0000-4000-8000-000000000000/materialize', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/series/00000000-0000-4000-8000-000000000000/materialize\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/series/00000000-0000-4000-8000-000000000000/materialize', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/occurrences/{id}/provider-mirrors/restore":{"post":{"operationId":"postV1OccurrencesByIdProviderMirrorsRestore","summary":"Restore a provider mirror the host removed externally","tags":["series"],"description":"When a host deletes a managed mirror event in Google, Calendar keeps the booking and marks the link omitted instead of recreating it. This command recreates the mirror on the selected connection (or every omitted link for the occurrence). Time, occupancy and clinical state are unchanged.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"uuid"},"in":"query","name":"connection_id","required":false,"description":"When set, restore only that connection; otherwise restore every omitted link for the occurrence."},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"occurrence_id":{"type":"string","format":"uuid"},"restored":{"type":"array","items":{"type":"object","properties":{"connection_id":{"type":"string","format":"uuid"},"action":{"type":"string"},"external_event_id":{"type":["string","null"]}},"required":["connection_id","action","external_event_id"],"additionalProperties":false}}},"required":["occurrence_id","restored"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000/provider-mirrors/restore \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000/provider-mirrors/restore', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/occurrences/00000000-0000-4000-8000-000000000000/provider-mirrors/restore\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/occurrences/00000000-0000-4000-8000-000000000000/provider-mirrors/restore', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/waitlist":{"post":{"operationId":"postV1Waitlist","summary":"Join the waitlist for an event type","tags":["waitlist"],"description":"Join the waitlist for an event type","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"event_type_id":{"type":"string","format":"uuid"},"attendee_ref":{"type":"string","minLength":1,"maxLength":255,"description":"Opaque participant id. Not a source-system patient id."},"timezone":{"type":"string","description":"IANA timezone identifier"},"locale":{"type":["string","null"],"minLength":2,"maxLength":35}},"required":["event_type_id","attendee_ref","timezone"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"event_type_id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"attendee_ref":{"type":"string","description":"Opaque participant id. Not a source-system patient id."},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"status":{"type":"string","enum":["waiting","offered","booked","expired","withdrawn"]},"offered_start":{"type":["string","null"]},"offer_expires_at":{"type":["string","null"]},"booking_id":{"type":["string","null"],"format":"uuid"},"created_at":{"type":"string"}},"required":["id","event_type_id","host_id","attendee_ref","timezone","locale","status","offered_start","offer_expires_at","booking_id","created_at"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/waitlist \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/waitlist', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/waitlist\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/waitlist', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]},"get":{"operationId":"getV1Waitlist","summary":"List who is waiting or holding an offer","tags":["waitlist"],"description":"List who is waiting or holding an offer","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"query","name":"event_type_id","required":false}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"event_type_id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"attendee_ref":{"type":"string","description":"Opaque participant id. Not a source-system patient id."},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"status":{"type":"string","enum":["waiting","offered","booked","expired","withdrawn"]},"offered_start":{"type":["string","null"]},"offer_expires_at":{"type":["string","null"]},"booking_id":{"type":["string","null"],"format":"uuid"},"created_at":{"type":"string"}},"required":["id","event_type_id","host_id","attendee_ref","timezone","locale","status","offered_start","offer_expires_at","booking_id","created_at"],"additionalProperties":false}}},"required":["data"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/waitlist \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/waitlist', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/waitlist\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/waitlist', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/waitlist/{id}/withdraw":{"post":{"operationId":"postV1WaitlistByIdWithdraw","summary":"Leave the waitlist","tags":["waitlist"],"description":"If this person was holding an offered start, the hold is released and the next person waiting is offered that start.","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"event_type_id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"attendee_ref":{"type":"string","description":"Opaque participant id. Not a source-system patient id."},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"status":{"type":"string","enum":["waiting","offered","booked","expired","withdrawn"]},"offered_start":{"type":["string","null"]},"offer_expires_at":{"type":["string","null"]},"booking_id":{"type":["string","null"],"format":"uuid"},"created_at":{"type":"string"}},"required":["id","event_type_id","host_id","attendee_ref","timezone","locale","status","offered_start","offer_expires_at","booking_id","created_at"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/waitlist/00000000-0000-4000-8000-000000000000/withdraw \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/waitlist/00000000-0000-4000-8000-000000000000/withdraw', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/waitlist/00000000-0000-4000-8000-000000000000/withdraw\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/waitlist/00000000-0000-4000-8000-000000000000/withdraw', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/data-subjects/{subjectRef}/access-log":{"get":{"operationId":"getV1DataSubjectsBySubjectrefAccessLog","summary":"Accesses recorded for one data subject","tags":["privacy"],"description":"Returns recorded access metadata for one opaque reference inside the selected tenant. The DTO exposes actor capacity; the integrator handles identity resolution and applicable disclosure policy.","parameters":[{"schema":{"type":"string","format":"date-time"},"in":"query","name":"since","required":false,"description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},{"schema":{"type":"integer","minimum":1,"maximum":1000,"default":200},"in":"query","name":"limit","required":false},{"schema":{"type":"string","minLength":1,"maxLength":255},"in":"path","name":"subjectRef","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"subject_ref":{"type":"string"},"data":{"type":"array","items":{"type":"object","properties":{"occurred_at":{"type":"string"},"operation":{"type":"string"},"resource_type":{"type":"string"},"resource_id":{"type":["string","null"]},"fields_accessed":{"type":"array","items":{"type":"string"}},"actor_kind":{"type":"string"},"purpose":{"type":["string","null"]},"notified_at":{"type":["string","null"]}},"required":["occurred_at","operation","resource_type","resource_id","fields_accessed","actor_kind","purpose","notified_at"],"additionalProperties":false}}},"required":["subject_ref","data"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/data-subjects/example/access-log \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/data-subjects/example/access-log', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/data-subjects/example/access-log\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/data-subjects/example/access-log', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/privacy-settings":{"patch":{"operationId":"patchV1PrivacySettings","summary":"Set the tenant privacy posture","tags":["privacy"],"description":"Tenant privacy configuration. Access recording remains enabled; notification and retention depend on the integrator policy. data_region is declaration metadata and does not route or prove regional compliance.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"access_notification_mode":{"type":"string","enum":["record_only","notify"]},"booking_retention_days":{"type":"integer","minimum":1,"maximum":36500},"audit_retention_days":{"type":"integer","minimum":1,"maximum":36500},"data_region":{"type":"string","maxLength":64}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/privacy-settings \\\n  --request PATCH \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/privacy-settings', {\n  method: 'PATCH',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"PATCH\",\n    \"/v1/privacy-settings\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('PATCH', 'https://api.calendar.anam.app/v1/privacy-settings', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/booking-tokens":{"post":{"operationId":"postV1BookingTokens","summary":"Mint a short-lived public booking token","tags":["public"],"description":"Scoped to one event type and optionally one host. Grants only reading slots, taking or renewing a hold, and creating a booking. It cannot list bookings or reach another event type.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"event_type_id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"recovery_for":{"type":"object","properties":{"operation_key":{"type":"string","minLength":8,"maxLength":128},"delivery":{"type":"string","enum":["email"]},"operation_path":{"type":"string","maxLength":1024,"pattern":"^\\/public\\/v1\\/[^/?#]+\\/[^/?#]+\\/[^/?#]+\\/bookings$"},"booking_body":{"type":"object","properties":{"hold_token":{"type":"string","minLength":1,"maxLength":512},"preferred_start":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"attendee":{"type":"object","properties":{"timezone":{"type":"string","description":"IANA timezone identifier"},"locale":{"type":["string","null"],"maxLength":35}},"required":["timezone"],"additionalProperties":false}},"required":["hold_token","attendee"],"additionalProperties":false}},"required":["operation_key","operation_path","booking_body"],"additionalProperties":false},"scopes":{"type":"array","items":{"type":"string","enum":["slots:read","hold:write","booking:write"]},"minItems":1,"maxItems":3},"attendee_ref":{"type":"string","minLength":1,"maxLength":255,"description":"Opaque participant id that this token may book for. Not a source-system patient id, e-mail, phone or name. Binding it stops the browser from booking as anyone else."}},"required":["event_type_id"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string"},"id":{"type":"string"},"expires_at":{"type":"string"},"event_type_id":{"type":"string","format":"uuid"},"host_id":{"type":["string","null"],"format":"uuid"},"scopes":{"type":"array","items":{"type":"string"}},"tenant_id":{"type":"string","format":"uuid"},"recovery_code":{"type":"string"},"recovery_expires_at":{"type":"string"},"tenant_ref":{"type":["string","null"],"description":"Caller-owned opaque tenant ref; server integration metadata, never a credential"}},"required":["token","id","expires_at","event_type_id","host_id","scopes"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/booking-tokens \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/booking-tokens', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/booking-tokens\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/booking-tokens', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/booking-tokens/{id}":{"delete":{"operationId":"deleteV1BookingTokensById","summary":"Revoke an already issued public booking grant","tags":["public"],"description":"Revoke an already issued public booking grant","parameters":[{"schema":{"type":"string","pattern":"^btk_[0-9a-f-]{36}$"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"204":{"description":"Default Response","content":{"application/json":{"schema":{"enum":["null"]}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/booking-tokens/00000000-0000-4000-8000-000000000000 \\\n  --request DELETE \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/booking-tokens/00000000-0000-4000-8000-000000000000', {\n  method: 'DELETE',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"DELETE\",\n    \"/v1/booking-tokens/00000000-0000-4000-8000-000000000000\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('DELETE', 'https://api.calendar.anam.app/v1/booking-tokens/00000000-0000-4000-8000-000000000000', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/participant-access/challenges":{"post":{"operationId":"postV1ParticipantAccessChallenges","summary":"Send an email access code to an application-authorized opaque contact","tags":["public"],"description":"Send an email access code to an application-authorized opaque contact","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"host_id":{"type":"string","format":"uuid"},"recipient_ref":{"type":"string","minLength":1,"maxLength":255},"attendee_refs":{"type":"array","items":{"type":"string","minLength":1,"maxLength":255},"minItems":1,"maxItems":100},"locale":{"type":"string","enum":["pt-BR","pt-PT","en-US","es-ES","fr-FR"]},"request_key":{"type":"string","format":"uuid"},"access_scopes":{"type":"array","items":{"type":"object","properties":{"tenant_id":{"type":"string","format":"uuid"},"subject_id":{"type":"string","format":"uuid"},"attendee_refs":{"type":"array","items":{"type":"string","minLength":1,"maxLength":255},"minItems":1,"maxItems":100}},"required":["tenant_id","subject_id","attendee_refs"],"additionalProperties":false},"maxItems":100}},"required":["host_id","recipient_ref","attendee_refs","locale","request_key"],"additionalProperties":false}}}},"responses":{"200":{"description":"Default Response"}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/participant-access/challenges \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/participant-access/challenges', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/participant-access/challenges\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/participant-access/challenges', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/public/v1/participant-access/{tenantId}/verify":{"post":{"operationId":"postPublicV1ParticipantAccessByTenantidVerify","summary":"Submit /public/v1/participant-access/{tenantId}/verify","tags":["public"],"description":"Submit /public/v1/participant-access/{tenantId}/verify","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"challenge_id":{"type":"string","format":"uuid"},"code":{"type":"string","pattern":"^\\d{6}$"},"exchange_key":{"type":"string","format":"uuid"}},"required":["challenge_id","code","exchange_key"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"tenantId","required":true}],"responses":{"200":{"description":"Default Response"}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/public/v1/participant-access/00000000-0000-4000-8000-000000000000/verify \\\n  --request POST \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/public/v1/participant-access/00000000-0000-4000-8000-000000000000/verify', {\n  method: 'POST',\n  headers: {\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/public/v1/participant-access/00000000-0000-4000-8000-000000000000/verify\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/public/v1/participant-access/00000000-0000-4000-8000-000000000000/verify', [\n  'headers' => [\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/public/v1/participant-access/{tenantId}/bookings":{"get":{"operationId":"getPublicV1ParticipantAccessByTenantidBookings","summary":"Read /public/v1/participant-access/{tenantId}/bookings","tags":["public"],"description":"Read /public/v1/participant-access/{tenantId}/bookings","parameters":[{"schema":{"type":"string","format":"date-time"},"in":"query","name":"from","required":true,"description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"to","required":true,"description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},{"schema":{"type":"string","maxLength":180},"in":"query","name":"after","required":false},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"tenantId","required":true}],"responses":{"200":{"description":"Default Response"}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/public/v1/participant-access/00000000-0000-4000-8000-000000000000/bookings \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/public/v1/participant-access/00000000-0000-4000-8000-000000000000/bookings', {\n  headers: {\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/public/v1/participant-access/00000000-0000-4000-8000-000000000000/bookings\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/public/v1/participant-access/00000000-0000-4000-8000-000000000000/bookings', [\n  'headers' => [\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/public/v1/participant-access/{tenantId}/session":{"delete":{"operationId":"deletePublicV1ParticipantAccessByTenantidSession","summary":"Delete /public/v1/participant-access/{tenantId}/session","tags":["public"],"description":"Delete /public/v1/participant-access/{tenantId}/session","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"path","name":"tenantId","required":true}],"responses":{"200":{"description":"Default Response"}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/public/v1/participant-access/00000000-0000-4000-8000-000000000000/session \\\n  --request DELETE \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/public/v1/participant-access/00000000-0000-4000-8000-000000000000/session', {\n  method: 'DELETE',\n  headers: {\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"DELETE\",\n    \"/public/v1/participant-access/00000000-0000-4000-8000-000000000000/session\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('DELETE', 'https://api.calendar.anam.app/public/v1/participant-access/00000000-0000-4000-8000-000000000000/session', [\n  'headers' => [\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/public/v1/{tenantSlug}/{hostRef}/{eventTypeSlug}":{"get":{"operationId":"getPublicV1ByTenantslugByHostrefByEventtypeslug","summary":"Read a published event type","tags":["public"],"description":"Read a published event type","parameters":[{"schema":{"type":"string"},"in":"path","name":"tenantSlug","required":true},{"schema":{"type":"string"},"in":"path","name":"hostRef","required":true},{"schema":{"type":"string"},"in":"path","name":"eventTypeSlug","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"tenant":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"}},"required":["slug","name"],"additionalProperties":false},"organization":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"}},"required":["slug","name"],"additionalProperties":false},"branding":{"type":"object","properties":{"slug":{"type":"string"},"host":{"type":["string","null"]},"brand_name":{"type":"string"},"offered_by":{"type":["string","null"]},"logo_url":{"type":["string","null"]},"favicon_url":{"type":["string","null"]},"primary_color":{"type":"string"},"background_color":{"type":"string"},"text_color":{"type":"string"},"accent_color":{"type":"string"},"primary_foreground":{"type":"string"},"accent_foreground":{"type":"string"},"locale":{"type":"string"},"default_timezone":{"type":"string"},"booking_title":{"type":["string","null"]},"booking_subtitle":{"type":["string","null"]},"booking_guidance_title":{"type":["string","null"]},"confirmation_text":{"type":["string","null"]},"cancellation_text":{"type":["string","null"]},"footer_text":{"type":["string","null"]},"empty_slots_text":{"type":["string","null"]},"show_service_mark":{"type":"boolean"}},"required":["slug","host","brand_name","offered_by","logo_url","favicon_url","primary_color","background_color","text_color","accent_color","primary_foreground","accent_foreground","locale","default_timezone","booking_title","booking_subtitle","booking_guidance_title","confirmation_text","cancellation_text","footer_text","empty_slots_text","show_service_mark"],"additionalProperties":false},"capabilities":{"type":"object","properties":{"booking_recovery":{"type":"boolean"},"booking_recovery_email":{"type":"boolean"},"auto_reschedule":{"type":"boolean"}},"required":["booking_recovery","booking_recovery_email","auto_reschedule"],"additionalProperties":false},"host":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"ref":{"type":["string","null"]},"display_label":{"type":"string"},"public_profile":{"type":"object","properties":{"show_logo":{"type":"boolean"},"professional_name":{"type":["string","null"],"minLength":1,"maxLength":200,"pattern":"^[^<>\\p{Cc}]+$"},"calendar_name":{"type":["string","null"],"minLength":1,"maxLength":200,"pattern":"^[^<>\\p{Cc}]+$"},"registration":{"type":["string","null"],"minLength":1,"maxLength":80,"pattern":"^[^<>\\p{Cc}]+$"},"profession":{"type":["string","null"],"minLength":1,"maxLength":120,"pattern":"^[^<>\\p{Cc}]+$"},"photo_url":{"type":["string","null"],"maxLength":2048,"format":"uri"},"email":{"type":["string","null"],"maxLength":254,"format":"email"},"phone":{"type":["string","null"],"pattern":"^\\+[1-9]\\d{6,14}$"}},"additionalProperties":false},"timezone":{"type":"string"}},"required":["id","ref","display_label","timezone"],"additionalProperties":false},"event_type":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":["string","null"]},"duration_minutes":{"type":"integer"},"requires_approval":{"type":"boolean"},"max_horizon_days":{"type":"integer"},"min_notice_minutes":{"type":"integer"},"location_kind":{"type":"string"},"capacity":{"type":"integer"}},"required":["id","slug","name","description","duration_minutes","requires_approval","max_horizon_days","min_notice_minutes","location_kind","capacity"],"additionalProperties":false}},"required":["tenant","organization","branding","capabilities","host","event_type"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/public/v1/example/example/example \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/public/v1/example/example/example', {\n  headers: {\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/public/v1/example/example/example\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/public/v1/example/example/example', [\n  'headers' => [\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/public/v1/{tenantSlug}/{hostRef}/{eventTypeSlug}/slots":{"get":{"operationId":"getPublicV1ByTenantslugByHostrefByEventtypeslugSlots","summary":"List bookable slots for the public page","tags":["public"],"description":"List bookable slots for the public page","parameters":[{"schema":{"type":"string","format":"date-time"},"in":"query","name":"from","required":true,"description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"to","required":true,"description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},{"schema":{"type":"string"},"in":"query","name":"timezone","required":false,"description":"IANA timezone identifier"},{"schema":{"anyOf":[{"type":"string","enum":["true"]},{"type":"string","enum":["false"]},{"type":"boolean"}]},"in":"query","name":"include_unavailable","required":false},{"schema":{"type":"string"},"in":"path","name":"tenantSlug","required":true},{"schema":{"type":"string"},"in":"path","name":"hostRef","required":true},{"schema":{"type":"string"},"in":"path","name":"eventTypeSlug","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/public/v1/example/example/example/slots \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/public/v1/example/example/example/slots', {\n  headers: {\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/public/v1/example/example/example/slots\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/public/v1/example/example/example/slots', [\n  'headers' => [\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/public/v1/{tenantSlug}/{hostRef}/{eventTypeSlug}/auto-reschedule/queue":{"get":{"operationId":"getPublicV1ByTenantslugByHostrefByEventtypeslugAutoRescheduleQueue","summary":"Preview the next position for a preferred-time replacement","tags":["public"],"description":"An anonymous aggregate for this host and instant. Enrollment occurs atomically with the backup booking; this preview does not reserve a position.","parameters":[{"schema":{"type":"string","format":"date-time"},"in":"query","name":"preferred_start","required":true,"description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},{"schema":{"type":"string"},"in":"path","name":"tenantSlug","required":true},{"schema":{"type":"string"},"in":"path","name":"hostRef","required":true},{"schema":{"type":"string"},"in":"path","name":"eventTypeSlug","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"next_position":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["next_position"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/public/v1/example/example/example/auto-reschedule/queue \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/public/v1/example/example/example/auto-reschedule/queue', {\n  headers: {\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/public/v1/example/example/example/auto-reschedule/queue\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/public/v1/example/example/example/auto-reschedule/queue', [\n  'headers' => [\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/public/v1/{tenantSlug}/{hostRef}/{eventTypeSlug}/holds":{"post":{"operationId":"postPublicV1ByTenantslugByHostrefByEventtypeslugHolds","summary":"Hold a slot from the public page","tags":["public"],"description":"Requires a booking token scoped to this event type. One active hold per booking grant: creating a new hold releases prior active holds from the same grant (and an optional replace_hold_token) before claiming the new slot.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"starts_at":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"attendee_timezone":{"type":"string","description":"IANA timezone identifier"},"replace_hold_token":{"type":"string","minLength":1}},"required":["starts_at","attendee_timezone"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"tenantSlug","required":true},{"schema":{"type":"string"},"in":"path","name":"hostRef","required":true},{"schema":{"type":"string"},"in":"path","name":"eventTypeSlug","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/public/v1/example/example/example/holds \\\n  --request POST \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/public/v1/example/example/example/holds', {\n  method: 'POST',\n  headers: {\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/public/v1/example/example/example/holds\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/public/v1/example/example/example/holds', [\n  'headers' => [\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/public/v1/{tenantSlug}/{hostRef}/{eventTypeSlug}/holds/renew":{"post":{"operationId":"postPublicV1ByTenantslugByHostrefByEventtypeslugHoldsRenew","summary":"Extend a hold while the visitor fills in the form","tags":["public"],"description":"Requires a booking token scoped to this event type.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string"}},"required":["token"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"tenantSlug","required":true},{"schema":{"type":"string"},"in":"path","name":"hostRef","required":true},{"schema":{"type":"string"},"in":"path","name":"eventTypeSlug","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/public/v1/example/example/example/holds/renew \\\n  --request POST \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/public/v1/example/example/example/holds/renew', {\n  method: 'POST',\n  headers: {\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/public/v1/example/example/example/holds/renew\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/public/v1/example/example/example/holds/renew', [\n  'headers' => [\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/public/v1/{tenantSlug}/{hostRef}/{eventTypeSlug}/holds/release":{"post":{"operationId":"postPublicV1ByTenantslugByHostrefByEventtypeslugHoldsRelease","summary":"Release a hold from the public page","tags":["public"],"description":"Requires a booking token scoped to this event type. Visitors call this when they abandon a reserved slot before booking.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string","minLength":1}},"required":["token"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"tenantSlug","required":true},{"schema":{"type":"string"},"in":"path","name":"hostRef","required":true},{"schema":{"type":"string"},"in":"path","name":"eventTypeSlug","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"released":{"type":"boolean","enum":[true]}},"required":["released"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/public/v1/example/example/example/holds/release \\\n  --request POST \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/public/v1/example/example/example/holds/release', {\n  method: 'POST',\n  headers: {\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/public/v1/example/example/example/holds/release\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/public/v1/example/example/example/holds/release', [\n  'headers' => [\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/public/v1/{tenantSlug}/{hostRef}/{eventTypeSlug}/bookings":{"post":{"operationId":"postPublicV1ByTenantslugByHostrefByEventtypeslugBookings","summary":"Convert a hold into a booking","tags":["public"],"description":"Requires a booking token scoped to this event type. The visitor supplies a timezone and a locale, and nothing else: the attendee reference comes from the token or from the hold, and this route accepts no name, e-mail, phone number or free-form metadata. Contact details belong to anam-messenger, which the tenant backend talks to before calling this route.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"hold_token":{"type":"string"},"preferred_start":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"attendee":{"type":"object","properties":{"timezone":{"type":"string","description":"IANA timezone identifier"},"locale":{"type":["string","null"],"maxLength":35}},"required":["timezone"],"additionalProperties":false}},"required":["hold_token","attendee"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string"},"in":"path","name":"tenantSlug","required":true},{"schema":{"type":"string"},"in":"path","name":"hostRef","required":true},{"schema":{"type":"string"},"in":"path","name":"eventTypeSlug","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/public/v1/example/example/example/bookings \\\n  --request POST \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/public/v1/example/example/example/bookings', {\n  method: 'POST',\n  headers: {\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/public/v1/example/example/example/bookings\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/public/v1/example/example/example/bookings', [\n  'headers' => [\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/public/v1/bookings/{manageToken}":{"get":{"operationId":"getPublicV1BookingsByManagetoken","summary":"Read a booking through its management token","tags":["public"],"description":"Read a booking through its management token","parameters":[{"schema":{"type":"string","maxLength":512},"in":"path","name":"manageToken","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/public/v1/bookings/example \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/public/v1/bookings/example', {\n  headers: {\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/public/v1/bookings/example\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/public/v1/bookings/example', [\n  'headers' => [\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/public/v1/booking-management":{"get":{"operationId":"getPublicV1BookingManagement","summary":"Read a booking through its management token","tags":["public"],"description":"Read a booking through its management token","parameters":[{"schema":{"type":"string","maxLength":512},"in":"path","name":"manageToken","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/public/v1/booking-management \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/public/v1/booking-management', {\n  headers: {\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/public/v1/booking-management\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/public/v1/booking-management', [\n  'headers' => [\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/public/v1/booking-management/auto-reschedule/withdraw":{"post":{"operationId":"postPublicV1BookingManagementAutoRescheduleWithdraw","summary":"Withdraw consent for automatic preferred-time replacement","tags":["public"],"description":"Withdraw consent for automatic preferred-time replacement","parameters":[{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/public/v1/booking-management/auto-reschedule/withdraw \\\n  --request POST \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/public/v1/booking-management/auto-reschedule/withdraw', {\n  method: 'POST',\n  headers: {\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/public/v1/booking-management/auto-reschedule/withdraw\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/public/v1/booking-management/auto-reschedule/withdraw', [\n  'headers' => [\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/public/v1/booking-management/slots":{"get":{"operationId":"getPublicV1BookingManagementSlots","summary":"List replacement times authorized by a reminder link","tags":["public"],"description":"List replacement times authorized by a reminder link","parameters":[{"schema":{"type":"string","format":"date-time"},"in":"query","name":"from","required":true,"description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},{"schema":{"type":"string","format":"date-time"},"in":"query","name":"to","required":true,"description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},{"schema":{"type":"string"},"in":"query","name":"timezone","required":false,"description":"IANA timezone identifier"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/public/v1/booking-management/slots \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/public/v1/booking-management/slots', {\n  headers: {\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/public/v1/booking-management/slots\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/public/v1/booking-management/slots', [\n  'headers' => [\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/public/v1/booking-management/holds":{"post":{"operationId":"postPublicV1BookingManagementHolds","summary":"Hold a replacement time authorized by a reminder link","tags":["public"],"description":"Hold a replacement time authorized by a reminder link","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"starts_at":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"attendee_timezone":{"type":"string","description":"IANA timezone identifier"}},"required":["starts_at","attendee_timezone"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/public/v1/booking-management/holds \\\n  --request POST \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/public/v1/booking-management/holds', {\n  method: 'POST',\n  headers: {\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/public/v1/booking-management/holds\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/public/v1/booking-management/holds', [\n  'headers' => [\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/public/v1/booking-management/respond":{"post":{"operationId":"postPublicV1BookingManagementRespond","summary":"Record primary participant intention for one exact occurrence","tags":["public"],"description":"Management capability in Authorization or X-Booking-Management-Token header only. Does not approve a host request, mark attendance, cancel occupancy, send invitations or change provider state. Legacy absence means unknown. Both expected versions are required; replay retains the original receipt and revalidates current capability.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"occurrence_id":{"type":"string","format":"uuid"},"expected_occurrence_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0},"expected_response_version":{"type":"integer","minimum":0},"response_status":{"type":"string","enum":["accepted","tentative","declined"]}},"required":["occurrence_id","expected_occurrence_revision","expected_response_version","response_status"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"booking":{"type":"object","properties":{"auto_reschedule":{"type":["object","null"],"properties":{"queue_position":{"type":["integer","null"],"exclusiveMinimum":true,"minimum":0},"id":{"type":"string","format":"uuid"},"occurrence_id":{"type":"string","format":"uuid"},"preferred_start":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"status":{"type":"string","enum":["waiting","applied","withdrawn","expired"]},"result_occurrence_id":{"type":["string","null"],"format":"uuid"}},"required":["queue_position","id","occurrence_id","preferred_start","status","result_occurrence_id"],"additionalProperties":false},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"reschedule_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"deletion_scopes":{"type":"array","items":{"type":"string","enum":["this","this_and_following","all"]},"maxItems":3},"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"event_type_id":{"type":"string","format":"uuid"},"host_id":{"type":"string","format":"uuid"},"sequence":{"type":"integer"},"title":{"type":["string","null"],"minLength":1,"maxLength":160,"description":"Private display title. Not copied to provider calendars or notifications."},"availability":{"type":"string","enum":["busy","free"],"description":"Busy reserves time in the occupancy ledger; free remains visible without blocking time."},"duration_minutes":{"type":["integer","null"],"minimum":1,"maximum":1440},"external_ref":{"type":["string","null"],"description":"Caller-owned id of this booking. Not a participant id."},"session_package_id":{"type":["string","null"],"format":"uuid","description":"Balance this booking draws from. Null when the booking is not part of a package."},"tenant_metadata":{"type":"object","additionalProperties":{}},"occurrences":{"type":"array","items":{"type":"object","properties":{"recurrence_rule":{"type":"string","maxLength":1024,"description":"Rule for the occurrence’s own series, when read in booking detail."},"attendee_override":{"type":["array","null"],"items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false}},"communication_plan":{"type":["object","null"],"properties":{"participant_channels":{"type":"array","items":{"type":"string","enum":["email","whatsapp"]},"maxItems":2},"reminders":{"type":"array","items":{"type":"object","properties":{"channel":{"type":"string","enum":["email","whatsapp","sms"]},"lead_minutes":{"type":"integer","minimum":1,"maximum":43200},"template_key":{"type":"string","minLength":1,"maxLength":128},"recipient":{"type":"string","enum":["participant","host"]}},"required":["channel","lead_minutes"],"additionalProperties":false},"maxItems":18},"host_lead_minutes":{"type":"array","items":{"type":"integer","minimum":1,"maximum":43200},"maxItems":6},"host_updates":{"type":"boolean"}},"required":["participant_channels","reminders","host_lead_minutes","host_updates"],"additionalProperties":false},"event_metadata":{"type":"object","additionalProperties":{"anyOf":[{"type":"string","maxLength":256},{"type":"number"},{"type":"boolean"},{"enum":["null"]}]},"description":"Flat, bounded opaque occurrence references owned by the integrator. No names, clinical content or credentials. Not authorization. Not projected to providers, messenger commands, inbox or public pages."},"event_details":{"type":"object","properties":{"link":{"type":["string","null"],"maxLength":800},"address":{"type":["string","null"],"minLength":1,"maxLength":1024},"description":{"type":["string","null"],"minLength":1,"maxLength":2000,"description":"Scheduling instructions visible in managed external calendars. Never include clinical or confidential notes."}},"additionalProperties":false},"conference_state":{"type":["string","null"],"enum":["pending","ready","failed"]},"root_occurrence_id":{"type":"string","format":"uuid"},"recurrence_order_local":{"type":["string","null"]},"id":{"type":"string","format":"uuid"},"booking_id":{"type":"string","format":"uuid"},"series_id":{"type":["string","null"],"format":"uuid"},"starts_at":{"type":"string"},"ends_at":{"type":"string"},"starts_local":{"type":"string"},"host_timezone":{"type":"string"},"status":{"type":"string","enum":["pending_approval","confirmed","declined","cancelled","completed","no_show"]},"revision":{"type":"integer"},"tz_resolution":{"type":["string","null"],"enum":["exact","shifted_forward","first_of_ambiguous"]},"dst_shift_flag":{"type":"boolean"},"rescheduled_from_id":{"type":["string","null"],"format":"uuid"},"join_url":{"type":["string","null"]},"covering_host_id":{"type":["string","null"],"format":"uuid","description":"Host delivering this occurrence when it is not the booking host. Null means the booking host."},"participant_responses":{"type":"array","items":{"type":"object","properties":{"attendee_ref":{"type":"string"},"response_status":{"type":"string","enum":["accepted","tentative","declined","needs_action"]},"response_source":{"type":"string","enum":["participant","host"]},"version":{"type":"integer","exclusiveMinimum":true,"minimum":0},"responded_at":{"type":"string"},"occurrence_revision":{"type":"integer","exclusiveMinimum":true,"minimum":0}},"required":["attendee_ref","response_status","version","responded_at","occurrence_revision"],"additionalProperties":false},"maxItems":50,"description":"Response for this exact revision. A host may record it on behalf of the participant or reset it to needs_action. Absence means unknown."}},"required":["id","booking_id","series_id","starts_at","ends_at","starts_local","host_timezone","status","revision","tz_resolution","dst_shift_flag","rescheduled_from_id","join_url","covering_host_id"],"additionalProperties":false},"maxItems":2048,"description":"Complete non-removed occurrence history, up to 2048 rows. Larger aggregates return 422 booking_detail_limit_exceeded without truncation; use the bounded summary and operational reconciliation."},"attendees":{"type":"array","items":{"type":"object","properties":{"external_ref":{"type":"string","description":"Opaque participant id minted by the tenant. Not a source-system patient id."},"role":{"type":"string","enum":["primary","guest"]},"timezone":{"type":"string"},"locale":{"type":["string","null"]},"response_status":{"type":"string"}},"required":["external_ref","role","timezone","locale","response_status"],"additionalProperties":false},"maxItems":50},"created_at":{"type":["string","null"]},"updated_at":{"type":["string","null"]}},"required":["id","status","event_type_id","host_id","sequence","external_ref","session_package_id","tenant_metadata","occurrences","attendees","created_at","updated_at"],"additionalProperties":false}},"required":["booking"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/public/v1/booking-management/respond \\\n  --request POST \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/public/v1/booking-management/respond', {\n  method: 'POST',\n  headers: {\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/public/v1/booking-management/respond\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/public/v1/booking-management/respond', [\n  'headers' => [\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/public/v1/bookings/{manageToken}/cancel":{"post":{"operationId":"postPublicV1BookingsByManagetokenCancel","summary":"Cancel through the management token","tags":["public"],"description":"Cancel through the management token","requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"not":{}},{"type":"object","properties":{"reason":{"type":["string","null"],"maxLength":500},"justification":{"type":"string","minLength":1,"maxLength":500}},"additionalProperties":false}]}}}},"parameters":[{"schema":{"type":"string","maxLength":512},"in":"path","name":"manageToken","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/public/v1/bookings/example/cancel \\\n  --request POST \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/public/v1/bookings/example/cancel', {\n  method: 'POST',\n  headers: {\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/public/v1/bookings/example/cancel\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/public/v1/bookings/example/cancel', [\n  'headers' => [\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/public/v1/booking-management/cancel":{"post":{"operationId":"postPublicV1BookingManagementCancel","summary":"Cancel through the management token","tags":["public"],"description":"Cancel through the management token","requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"not":{}},{"type":"object","properties":{"reason":{"type":["string","null"],"maxLength":500},"justification":{"type":"string","minLength":1,"maxLength":500}},"additionalProperties":false}]}}}},"parameters":[{"schema":{"type":"string","maxLength":512},"in":"path","name":"manageToken","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/public/v1/booking-management/cancel \\\n  --request POST \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/public/v1/booking-management/cancel', {\n  method: 'POST',\n  headers: {\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/public/v1/booking-management/cancel\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/public/v1/booking-management/cancel', [\n  'headers' => [\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/public/v1/bookings/{manageToken}/reschedule":{"post":{"operationId":"postPublicV1BookingsByManagetokenReschedule","summary":"Reschedule through the management token","tags":["public"],"description":"Reschedule through the management token","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"hold_token":{"type":"string"},"starts_at":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"justification":{"type":"string","minLength":1,"maxLength":500}},"required":["hold_token","starts_at"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","maxLength":512},"in":"path","name":"manageToken","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/public/v1/bookings/example/reschedule \\\n  --request POST \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/public/v1/bookings/example/reschedule', {\n  method: 'POST',\n  headers: {\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/public/v1/bookings/example/reschedule\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/public/v1/bookings/example/reschedule', [\n  'headers' => [\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/public/v1/booking-management/reschedule":{"post":{"operationId":"postPublicV1BookingManagementReschedule","summary":"Reschedule through the management token","tags":["public"],"description":"Reschedule through the management token","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"hold_token":{"type":"string"},"starts_at":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"},"justification":{"type":"string","minLength":1,"maxLength":500}},"required":["hold_token","starts_at"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","maxLength":512},"in":"path","name":"manageToken","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"410":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/public/v1/booking-management/reschedule \\\n  --request POST \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/public/v1/booking-management/reschedule', {\n  method: 'POST',\n  headers: {\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/public/v1/booking-management/reschedule\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/public/v1/booking-management/reschedule', [\n  'headers' => [\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/public/v1/booking-recovery/exchange":{"post":{"operationId":"postPublicV1BookingRecoveryExchange","summary":"Exchange one private recovery code for a five-minute read-only receipt grant","tags":["public"],"description":"Private code in Authorization, never URL/body/storage. Idempotency-Key required for lost exchange reply. Never renews mutation authority, retries an effect or exposes management/booking bearers.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"token":{"type":"string"},"expires_at":{"type":"string"}},"required":["token","expires_at"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/public/v1/booking-recovery/exchange \\\n  --request POST \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/public/v1/booking-recovery/exchange', {\n  method: 'POST',\n  headers: {\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/public/v1/booking-recovery/exchange\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/public/v1/booking-recovery/exchange', [\n  'headers' => [\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/public/v1/booking-recovery/receipt":{"get":{"operationId":"getPublicV1BookingRecoveryReceipt","summary":"Read exact original receipt and currently authorized booking state","tags":["public"],"description":"Missing receipt means pending, never proof of failed creation. Allowlist DTO has no live bearer, management token, attendees or contact. Current is null if the booking was removed or moved outside this resource. Historical original receipt metadata never reactivates it.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"state":{"type":"string","enum":["receipt_pending","recorded"]},"receipt":{"type":"object","properties":{"operation_id":{"type":["string","null"],"format":"uuid"},"original_status":{"type":"integer"},"booking_id":{"type":"string","format":"uuid"},"sequence":{"type":"integer"}},"required":["operation_id","original_status","booking_id","sequence"],"additionalProperties":false},"current":{"type":["object","null"],"properties":{"id":{"type":"string","format":"uuid"},"status":{"type":"string"},"sequence":{"type":"integer"},"occurrences_truncated":{"type":"boolean"},"occurrences":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"starts_at":{"type":"string"},"ends_at":{"type":"string"},"host_timezone":{"type":"string"},"status":{"type":"string"},"revision":{"type":"integer"}},"required":["id","starts_at","ends_at","host_timezone","status","revision"],"additionalProperties":false},"maxItems":366}},"required":["id","status","sequence","occurrences_truncated","occurrences"],"additionalProperties":false}},"required":["state"],"additionalProperties":false}}}},"202":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"state":{"type":"string","enum":["receipt_pending","recorded"]},"receipt":{"type":"object","properties":{"operation_id":{"type":["string","null"],"format":"uuid"},"original_status":{"type":"integer"},"booking_id":{"type":"string","format":"uuid"},"sequence":{"type":"integer"}},"required":["operation_id","original_status","booking_id","sequence"],"additionalProperties":false},"current":{"type":["object","null"],"properties":{"id":{"type":"string","format":"uuid"},"status":{"type":"string"},"sequence":{"type":"integer"},"occurrences_truncated":{"type":"boolean"},"occurrences":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"starts_at":{"type":"string"},"ends_at":{"type":"string"},"host_timezone":{"type":"string"},"status":{"type":"string"},"revision":{"type":"integer"}},"required":["id","starts_at","ends_at","host_timezone","status","revision"],"additionalProperties":false},"maxItems":366}},"required":["id","status","sequence","occurrences_truncated","occurrences"],"additionalProperties":false}},"required":["state"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"500":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/public/v1/booking-recovery/receipt \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/public/v1/booking-recovery/receipt', {\n  headers: {\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/public/v1/booking-recovery/receipt\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/public/v1/booking-recovery/receipt', [\n  'headers' => [\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/organization/branding":{"get":{"operationId":"getV1OrganizationBranding","summary":"Read organization branding, or one tenant override","tags":["branding"],"description":"Without a tenant, returns the organization default. With Anam-Tenant or tenant_id, returns that professional's override. `effective` is what the public page will paint.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/organization/branding \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/organization/branding', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/organization/branding\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/organization/branding', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]},"put":{"operationId":"putV1OrganizationBranding","summary":"Update organization branding, or one tenant override","tags":["branding"],"description":"Fields present in the body are written. JSON null clears that field back to the default (organization) or to the inherited value (tenant). Omitted fields stay as they are. HTML in any text field is rejected. Colors are scored against WCAG 2.2 AA in `contrast` (advisory; weak contrast still saves). The labels of confirm, cancel and reschedule are not fields.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"brand_name":{"type":["string","null"],"maxLength":80},"offered_by":{"type":["string","null"],"maxLength":120},"logo_url":{"type":["string","null"],"maxLength":2048},"favicon_url":{"type":["string","null"],"maxLength":2048},"primary_color":{"type":["string","null"],"pattern":"^#[0-9A-Fa-f]{6}$"},"background_color":{"type":["string","null"],"pattern":"^#[0-9A-Fa-f]{6}$"},"text_color":{"type":["string","null"],"pattern":"^#[0-9A-Fa-f]{6}$"},"accent_color":{"type":["string","null"],"pattern":"^#[0-9A-Fa-f]{6}$"},"locale":{"type":["string","null"],"enum":["pt-BR","pt-PT","en-US","es-ES"]},"default_timezone":{"type":["string","null"],"description":"IANA timezone identifier"},"custom_host":{"type":["string","null"],"maxLength":253},"booking_title":{"type":["string","null"],"maxLength":120},"booking_subtitle":{"type":["string","null"],"maxLength":400},"booking_guidance_title":{"type":["string","null"],"maxLength":80},"confirmation_text":{"type":["string","null"],"maxLength":500},"cancellation_text":{"type":["string","null"],"maxLength":500},"footer_text":{"type":["string","null"],"maxLength":280},"empty_slots_text":{"type":["string","null"],"maxLength":280},"show_service_mark":{"type":["boolean","null"]}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/organization/branding \\\n  --request PUT \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/organization/branding', {\n  method: 'PUT',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"PUT\",\n    \"/v1/organization/branding\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('PUT', 'https://api.calendar.anam.app/v1/organization/branding', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/organization/branding/logo":{"put":{"operationId":"putV1OrganizationBrandingLogo","summary":"Upload a logo (PNG, JPEG or WebP, at most 5MB)","tags":["branding"],"description":"Upload a logo (PNG, JPEG or WebP, at most 5MB)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"content_type":{"type":"string","enum":["image/png","image/jpeg","image/webp"]},"data_base64":{"type":"string","minLength":1}},"required":["data_base64"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/organization/branding/logo \\\n  --request PUT \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/organization/branding/logo', {\n  method: 'PUT',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"PUT\",\n    \"/v1/organization/branding/logo\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('PUT', 'https://api.calendar.anam.app/v1/organization/branding/logo', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]},"delete":{"operationId":"deleteV1OrganizationBrandingLogo","summary":"Remove an uploaded logo","tags":["branding"],"description":"Remove an uploaded logo","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/organization/branding/logo \\\n  --request DELETE \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/organization/branding/logo', {\n  method: 'DELETE',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"DELETE\",\n    \"/v1/organization/branding/logo\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('DELETE', 'https://api.calendar.anam.app/v1/organization/branding/logo', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/organization/branding/favicon":{"put":{"operationId":"putV1OrganizationBrandingFavicon","summary":"Upload a favicon (PNG, JPEG or WebP, at most 32KB)","tags":["branding"],"description":"Upload a favicon (PNG, JPEG or WebP, at most 32KB)","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"content_type":{"type":"string","enum":["image/png","image/jpeg","image/webp"]},"data_base64":{"type":"string","minLength":1}},"required":["data_base64"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/organization/branding/favicon \\\n  --request PUT \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/organization/branding/favicon', {\n  method: 'PUT',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"PUT\",\n    \"/v1/organization/branding/favicon\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('PUT', 'https://api.calendar.anam.app/v1/organization/branding/favicon', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]},"delete":{"operationId":"deleteV1OrganizationBrandingFavicon","summary":"Remove an uploaded favicon","tags":["branding"],"description":"Remove an uploaded favicon","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":{}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/organization/branding/favicon \\\n  --request DELETE \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/organization/branding/favicon', {\n  method: 'DELETE',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"DELETE\",\n    \"/v1/organization/branding/favicon\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('DELETE', 'https://api.calendar.anam.app/v1/organization/branding/favicon', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/public/v1/branding/by-host/{host}":{"get":{"operationId":"getPublicV1BrandingByHostByHost","summary":"Resolve a custom hostname to the organization it brands","tags":["public"],"description":"DNS and certificates are not issued here. The hostname is stored on the branding row so a later deployment can route `book.example.com` without inventing a second place to keep it.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":253},"in":"path","name":"host","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"},"host":{"type":"string"},"tenant_slug":{"type":["string","null"]},"branding":{"type":"object","properties":{"slug":{"type":"string"},"host":{"type":["string","null"]},"brand_name":{"type":"string"},"offered_by":{"type":["string","null"]},"logo_url":{"type":["string","null"]},"favicon_url":{"type":["string","null"]},"primary_color":{"type":"string"},"background_color":{"type":"string"},"text_color":{"type":"string"},"accent_color":{"type":"string"},"primary_foreground":{"type":"string"},"accent_foreground":{"type":"string"},"locale":{"type":"string"},"default_timezone":{"type":"string"},"booking_title":{"type":["string","null"]},"booking_subtitle":{"type":["string","null"]},"booking_guidance_title":{"type":["string","null"]},"confirmation_text":{"type":["string","null"]},"cancellation_text":{"type":["string","null"]},"footer_text":{"type":["string","null"]},"empty_slots_text":{"type":["string","null"]},"show_service_mark":{"type":"boolean"}},"required":["slug","host","brand_name","offered_by","logo_url","favicon_url","primary_color","background_color","text_color","accent_color","primary_foreground","accent_foreground","locale","default_timezone","booking_title","booking_subtitle","booking_guidance_title","confirmation_text","cancellation_text","footer_text","empty_slots_text","show_service_mark"],"additionalProperties":false}},"required":["slug","host","tenant_slug","branding"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/public/v1/branding/by-host/example \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/public/v1/branding/by-host/example', {\n  headers: {\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/public/v1/branding/by-host/example\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/public/v1/branding/by-host/example', [\n  'headers' => [\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/public/v1/branding/{organizationSlug}":{"get":{"operationId":"getPublicV1BrandingByOrganizationslug","summary":"Read the public branding for an organization","tags":["public"],"description":"Read the public branding for an organization","parameters":[{"schema":{"type":"string"},"in":"path","name":"organizationSlug","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"slug":{"type":"string"},"host":{"type":["string","null"]},"brand_name":{"type":"string"},"offered_by":{"type":["string","null"]},"logo_url":{"type":["string","null"]},"favicon_url":{"type":["string","null"]},"primary_color":{"type":"string"},"background_color":{"type":"string"},"text_color":{"type":"string"},"accent_color":{"type":"string"},"primary_foreground":{"type":"string"},"accent_foreground":{"type":"string"},"locale":{"type":"string"},"default_timezone":{"type":"string"},"booking_title":{"type":["string","null"]},"booking_subtitle":{"type":["string","null"]},"booking_guidance_title":{"type":["string","null"]},"confirmation_text":{"type":["string","null"]},"cancellation_text":{"type":["string","null"]},"footer_text":{"type":["string","null"]},"empty_slots_text":{"type":["string","null"]},"show_service_mark":{"type":"boolean"}},"required":["slug","host","brand_name","offered_by","logo_url","favicon_url","primary_color","background_color","text_color","accent_color","primary_foreground","accent_foreground","locale","default_timezone","booking_title","booking_subtitle","booking_guidance_title","confirmation_text","cancellation_text","footer_text","empty_slots_text","show_service_mark"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/public/v1/branding/example \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/public/v1/branding/example', {\n  headers: {\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/public/v1/branding/example\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/public/v1/branding/example', [\n  'headers' => [\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/public/v1/branding/{organizationSlug}/{kind}":{"get":{"operationId":"getPublicV1BrandingByOrganizationslugByKind","summary":"Read an uploaded logo or favicon","tags":["public"],"description":"Read an uploaded logo or favicon","parameters":[{"schema":{"type":"string"},"in":"query","name":"tenant","required":false},{"schema":{"type":"string"},"in":"path","name":"organizationSlug","required":true},{"schema":{"type":"string","enum":["logo","favicon"]},"in":"path","name":"kind","required":true}],"responses":{"200":{"description":"Default Response"}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/public/v1/branding/example/example \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/public/v1/branding/example/example', {\n  headers: {\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/public/v1/branding/example/example\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/public/v1/branding/example/example', [\n  'headers' => [\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/hosts/{hostId}/connections/{id}/calendars":{"get":{"operationId":"getV1HostsByHostidConnectionsByIdCalendars","summary":"List selectable provider calendars","tags":["connections"],"description":"One bounded page of calendar names, never event contents. The managed mirror is excluded. Selected sources and their opaque revision accompany each page.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","minLength":1,"maxLength":2048},"in":"query","name":"page_token","required":false},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"hostId","required":true},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","maxLength":1024},"name":{"type":"string","maxLength":500},"primary":{"type":"boolean"}},"required":["id","name","primary"],"additionalProperties":false},"maxItems":100},"next_page_token":{"type":["string","null"],"maxLength":2048},"selected_calendar_ids":{"type":"array","items":{"type":"string"},"maxItems":20},"etag":{"type":"string"}},"required":["data","next_page_token","selected_calendar_ids","etag"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}},"oauth_error":{"type":"string","description":"Stable reason. Clients switch on this; the prose in `detail` is for humans."},"missing_scopes":{"type":"array","items":{"type":"string"},"description":"Required scopes the provider did not grant, when oauth_error is missing_scope."}},"required":["type","title","status","code"],"additionalProperties":true}}}},"502":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/connections/00000000-0000-4000-8000-000000000000/calendars \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/connections/00000000-0000-4000-8000-000000000000/calendars', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/hosts/00000000-0000-4000-8000-000000000000/connections/00000000-0000-4000-8000-000000000000/calendars\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/connections/00000000-0000-4000-8000-000000000000/calendars', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]},"patch":{"operationId":"patchV1HostsByHostidConnectionsByIdCalendars","summary":"Choose calendars that block availability","tags":["connections"],"description":"Changes only free/busy source selection. Requires the opaque revision and an idempotency key. Clears obsolete busy projection and fences in-flight imports; the worker reconciles selected sources. Empty selection disables external blocking.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"calendar_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":1024},"maxItems":20}},"required":["calendar_ids"],"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"hostId","required":true},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."},{"schema":{"type":"string","minLength":1,"maxLength":128},"in":"header","name":"if-match","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"selected_calendar_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":1024},"maxItems":20},"etag":{"type":"string"}},"required":["selected_calendar_ids","etag"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"409":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"412":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}},"oauth_error":{"type":"string","description":"Stable reason. Clients switch on this; the prose in `detail` is for humans."},"missing_scopes":{"type":"array","items":{"type":"string"},"description":"Required scopes the provider did not grant, when oauth_error is missing_scope."}},"required":["type","title","status","code"],"additionalProperties":true}}}},"502":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/connections/00000000-0000-4000-8000-000000000000/calendars \\\n  --request PATCH \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/connections/00000000-0000-4000-8000-000000000000/calendars', {\n  method: 'PATCH',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"PATCH\",\n    \"/v1/hosts/00000000-0000-4000-8000-000000000000/connections/00000000-0000-4000-8000-000000000000/calendars\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('PATCH', 'https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/connections/00000000-0000-4000-8000-000000000000/calendars', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/hosts/{hostId}/connections/{provider}/authorize":{"post":{"operationId":"postV1HostsByHostidConnectionsByProviderAuthorize","summary":"Start connecting a calendar","tags":["connections"],"description":"Mints the provider authorization URL for one host. The return URL is refused, and no URL is minted, when it is not on the configured origin allowlist. The response carries the URL, the single-use state and when that state expires. Creating the calendar, opening the push channel and the first sync happen after the browser comes back, not in this call. An API credential needs config:write; a console session may call it for the host it is pinned to.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"return_url":{"type":"string","minLength":1,"description":"Where the browser is sent after consent. Checked against OAUTH_RETURN_URL_ALLOWLIST before an authorization URL is minted; a value that is not on that list is refused and never echoed. Omit it and the callback renders a result page instead of redirecting."},"freebusy_calendar_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":1024},"maxItems":20,"description":"The professional's own calendars whose busy time should block bookable slots. Titles and attendees are never read. Omit the field on a new connection and activation selects the provider primary calendar when one is visible. An empty list keeps the mirror only: personal appointments do not block anything, and PATCH may clear the selection later."},"force_consent":{"type":"boolean","description":"Ask the provider to show the consent screen again. Reconnect always does this, even when the flag is false: a refresh token is only issued on a fresh grant, and without one the connection dies within the hour."}},"additionalProperties":false}}}},"parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"hostId","required":true},{"schema":{"type":"string","pattern":"^[a-z0-9_-]{1,32}$"},"in":"path","name":"provider","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"authorization_url":{"type":"string","format":"uri"},"state":{"type":"string","description":"Single-use. Echoed by the provider; only its hash is stored."},"expires_at":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"}},"required":["authorization_url","state","expires_at"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}},"oauth_error":{"type":"string","description":"Stable reason. Clients switch on this; the prose in `detail` is for humans."},"missing_scopes":{"type":"array","items":{"type":"string"},"description":"Required scopes the provider did not grant, when oauth_error is missing_scope."}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/connections/example/authorize \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/connections/example/authorize', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/hosts/00000000-0000-4000-8000-000000000000/connections/example/authorize\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/connections/example/authorize', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/hosts/{hostId}/connections":{"get":{"operationId":"getV1HostsByHostidConnections","summary":"List a host's calendar connections","tags":["connections"],"description":"What the console shows on the connections screen. Each row says whether the connection works, when it last synced, whether push has fallen back to polling, and whether the professional has to reconnect. `consequence` is the part that matters in plain language: a dropped connection means personal appointments on the linked calendars stop blocking bookable slots, so a participant can be booked over a time that is already taken. Credentials are never included.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"hostId","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"provider":{"type":"string"},"account_email":{"type":["string","null"]},"status":{"type":"string","enum":["connecting","active","degraded","reauth_required","disabled"]},"connected_at":{"type":["string","null"]},"disconnected_at":{"type":["string","null"]},"last_successful_sync_at":{"type":["string","null"],"description":"The later of the last incremental sync and the last free/busy import."},"last_incremental_sync_at":{"type":["string","null"]},"last_freebusy_import_at":{"type":["string","null"]},"push_degraded_to_polling":{"type":"boolean","description":"True once the push channel was abandoned and the connection is being polled."},"polling_since":{"type":["string","null"]},"reconnect_needed":{"type":"boolean","description":"True when only the professional can fix it, by granting consent again."},"last_error":{"type":["string","null"]},"freebusy_calendar_ids":{"type":"array","items":{"type":"string"}},"consequence_code":{"type":"string","enum":["external_busy_blocking","external_busy_not_blocking","setup_incomplete","push_degraded","no_personal_calendars","disconnected","provider_degraded"]},"consequence":{"type":"string","description":"What is wrong, and what it costs: a dropped connection means personal appointments stop blocking bookable slots."}},"required":["id","provider","account_email","status","connected_at","disconnected_at","last_successful_sync_at","last_incremental_sync_at","last_freebusy_import_at","push_degraded_to_polling","polling_since","reconnect_needed","last_error","freebusy_calendar_ids","consequence_code","consequence"],"additionalProperties":false}},"oauth_providers":{"type":"array","items":{"type":"object","properties":{"provider":{"type":"string"},"configured":{"type":"boolean"}},"required":["provider","configured"],"additionalProperties":false},"description":"Deployment configuration only, not proof of provider availability or successful consent. Contains no credentials."}},"required":["data","oauth_providers"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}},"oauth_error":{"type":"string","description":"Stable reason. Clients switch on this; the prose in `detail` is for humans."},"missing_scopes":{"type":"array","items":{"type":"string"},"description":"Required scopes the provider did not grant, when oauth_error is missing_scope."}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/connections \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/connections', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/hosts/00000000-0000-4000-8000-000000000000/connections\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/connections', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/hosts/{hostId}/connections/{id}/reconnect":{"post":{"operationId":"postV1HostsByHostidConnectionsByIdReconnect","summary":"Reconnect a calendar","tags":["connections"],"description":"Starts consent again for an existing connection and returns a new authorization URL. The same calendar_connection row is reused; a second row would orphan the sync cursor, the event links and the push channel, and the provider column is unique per host anyway. Consent is forced even when force_consent is false, because a provider that already has a grant returns an access token and no refresh token, and storing that would replace a working connection with one that dies within the hour. A successful callback clears reauth_required.","requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"not":{}},{"type":"object","properties":{"return_url":{"type":"string","minLength":1,"description":"Where the browser is sent after consent. Checked against OAUTH_RETURN_URL_ALLOWLIST before an authorization URL is minted; a value that is not on that list is refused and never echoed. Omit it and the callback renders a result page instead of redirecting."},"freebusy_calendar_ids":{"type":"array","items":{"type":"string","minLength":1,"maxLength":1024},"maxItems":20,"description":"The professional's own calendars whose busy time should block bookable slots. Titles and attendees are never read. Omit the field on a new connection and activation selects the provider primary calendar when one is visible. An empty list keeps the mirror only: personal appointments do not block anything, and PATCH may clear the selection later."},"force_consent":{"type":"boolean","description":"Ask the provider to show the consent screen again. Reconnect always does this, even when the flag is false: a refresh token is only issued on a fresh grant, and without one the connection dies within the hour."}},"additionalProperties":false}]}}}},"parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"hostId","required":true},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-host","required":false,"description":"Optional narrowing assertion for one exact host; never grants authority. Refused on operations that cannot be narrowed."},{"schema":{"type":"string","format":"uuid"},"in":"header","name":"anam-event-type","required":false,"description":"Optional narrowing assertion for one exact event type, checked with current resource ownership before mutation and replay. Whole-host operations refuse it."},{"schema":{"type":"string","minLength":8,"maxLength":255},"in":"header","name":"idempotency-key","required":false,"description":"Required in practice for every state-changing POST. The same key with the same body replays the original response; with a different body it is 422; while the original is still running it is 409."}],"responses":{"201":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"authorization_url":{"type":"string","format":"uri"},"state":{"type":"string","description":"Single-use. Echoed by the provider; only its hash is stored."},"expires_at":{"type":"string","format":"date-time","description":"ISO 8601 instant, e.g. 2026-10-01T14:00:00Z"}},"required":["authorization_url","state","expires_at"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}},"oauth_error":{"type":"string","description":"Stable reason. Clients switch on this; the prose in `detail` is for humans."},"missing_scopes":{"type":"array","items":{"type":"string"},"description":"Required scopes the provider did not grant, when oauth_error is missing_scope."}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/connections/00000000-0000-4000-8000-000000000000/reconnect \\\n  --request POST \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json' \\\n  --header 'Content-Type: application/json' \\\n  --data '{}'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/connections/00000000-0000-4000-8000-000000000000/reconnect', {\n  method: 'POST',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json',\n    'Content-Type': 'application/json'\n  },\n  body: JSON.stringify({})\n})"},{"lang":"python","label":"python3","source":"import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\npayload = json.dumps({})\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\",\n  \"Content-Type\": \"application/json\"\n}\n\nconn.request(\n    \"POST\",\n    \"/v1/hosts/00000000-0000-4000-8000-000000000000/connections/00000000-0000-4000-8000-000000000000/reconnect\",\n    body=payload,\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('POST', 'https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/connections/00000000-0000-4000-8000-000000000000/reconnect', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json',\n    'Content-Type' => 'application/json'\n  ],\n  'json' => []\n]);"}]}},"/v1/hosts/{hostId}/connections/{id}":{"delete":{"operationId":"deleteV1HostsByHostidConnectionsById","summary":"Disconnect a calendar","tags":["connections"],"description":"Stops the push channel, revokes the token at the provider, clears imported busy blocks and marks the connection disabled. Repeating the call is success, including when the professional already removed the grant in their provider account: that is the common case, and it must not fail. purge=false leaves the calendar this service created, and the mirrored events on it, in the provider account. purge=true deletes that calendar, which deletes those events with it, and drops the local links so a later reconnect does not try to update a calendar that is gone. Credentials are cleared either way and are not returned.","parameters":[{"schema":{"type":"string","minLength":1},"in":"query","name":"tenant_id","required":false,"description":"Which tenant an organization credential is acting on: its id, its slug, or the reference the organization knows it by. Ignored by a credential already scoped to one tenant, and refused if it names a different one."},{"schema":{"type":"string","enum":["true","false"]},"in":"query","name":"purge","required":false,"description":"When true, delete the calendar this service created. When false or omitted, that calendar and its events stay in the provider account."},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"hostId","required":true},{"schema":{"type":"string","format":"uuid"},"in":"path","name":"id","required":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["disabled"]},"token_revoked":{"type":"boolean"},"already_disabled":{"type":"boolean"},"channel_stopped":{"type":"boolean"},"purge":{"type":"boolean"},"calendar_deleted":{"type":"boolean"},"mirrored_events":{"type":"string","enum":["left_on_provider","deleted_with_calendar"]},"recovery_required":{"type":"boolean"},"retry_after_seconds":{"type":["integer","null"]}},"required":["id","status","token_revoked","already_disabled","channel_stopped","purge","calendar_deleted","mirrored_events","recovery_required","retry_after_seconds"],"additionalProperties":false}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["type","title","status","code"],"additionalProperties":true}}}},"422":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"code":{"type":"string"},"detail":{"type":"string"},"instance":{"type":"string"},"requestId":{"type":"string"},"errors":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}},"oauth_error":{"type":"string","description":"Stable reason. Clients switch on this; the prose in `detail` is for humans."},"missing_scopes":{"type":"array","items":{"type":"string"},"description":"Required scopes the provider did not grant, when oauth_error is missing_scope."}},"required":["type","title","status","code"],"additionalProperties":true}}}}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/connections/00000000-0000-4000-8000-000000000000 \\\n  --request DELETE \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/connections/00000000-0000-4000-8000-000000000000', {\n  method: 'DELETE',\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"DELETE\",\n    \"/v1/hosts/00000000-0000-4000-8000-000000000000/connections/00000000-0000-4000-8000-000000000000\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('DELETE', 'https://api.calendar.anam.app/v1/hosts/00000000-0000-4000-8000-000000000000/connections/00000000-0000-4000-8000-000000000000', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}},"/v1/connections/{provider}/callback":{"get":{"operationId":"getV1ConnectionsByProviderCallback","summary":"OAuth callback","tags":["connections"],"description":"Where the provider sends the browser. There is no API credential: the single-use state authenticates the request, and a second delivery of the same state fails. On success the connection is stored as `connecting` and the calendar, push channel and first sync are scheduled rather than run here; the redirect's status query parameter is `connecting` until that finishes. The Location header is the return URL stored when the flow started, which was checked against the allowlist then. Nothing from this request's query string is copied into it. When no return URL was stored, the response is an HTML result page. `reason` on an error redirect is a stable code; `missing_scopes` names the scopes the provider withheld.","parameters":[{"schema":{"type":"string","maxLength":2048},"in":"query","name":"code","required":false},{"schema":{"type":"string","maxLength":512},"in":"query","name":"state","required":false},{"schema":{"type":"string","maxLength":128},"in":"query","name":"error","required":false},{"schema":{"type":"string","pattern":"^[a-z0-9_-]{1,32}$"},"in":"path","name":"provider","required":true}],"responses":{"200":{"description":"Default Response"}},"x-codeSamples":[{"lang":"shell","label":"curl","source":"curl https://api.calendar.anam.app/v1/connections/example/callback \\\n  --header 'Authorization: Bearer $CALENDAR_API_KEY' \\\n  --header 'Accept: application/json'"},{"lang":"javascript","label":"undici","source":"import { request } from 'undici'\n\nconst { statusCode, body } = await request('https://api.calendar.anam.app/v1/connections/example/callback', {\n  headers: {\n    Authorization: 'Bearer $CALENDAR_API_KEY',\n    Accept: 'application/json'\n  }\n})"},{"lang":"python","label":"python3","source":"import http.client\n\nconn = http.client.HTTPSConnection(\"api.calendar.anam.app\")\n\nheaders = {\n  \"Authorization\": \"Bearer $CALENDAR_API_KEY\",\n  \"Accept\": \"application/json\"\n}\n\nconn.request(\n    \"GET\",\n    \"/v1/connections/example/callback\",\n    headers=headers,\n)\n\nresponse = conn.getresponse()\nprint(response.read().decode())\n\nconn.close()"},{"lang":"php","label":"guzzle","source":"$client = new GuzzleHttp\\Client();\n\n$response = $client->request('GET', 'https://api.calendar.anam.app/v1/connections/example/callback', [\n  'headers' => [\n    'Authorization' => 'Bearer $CALENDAR_API_KEY',\n    'Accept' => 'application/json'\n  ]\n]);"}]}}},"servers":[{"url":"https://api.calendar.anam.app"}],"security":[{"apiKey":[]}],"x-tagGroups":[{"name":"Configuration","tags":["branding","configuration","console","tenants"]},{"name":"Connections","tags":["connections"]},{"name":"Delivery","tags":["notifications","webhooks"]},{"name":"Operations","tags":["audit","operations","privacy"]},{"name":"Public","tags":["public"]},{"name":"Scheduling","tags":["availability","bookings","holds","scheduling","series","waitlist"]}]}