Contracts 1.52.0
First served on the Phase 0 host by deploy #59 (2026-10-20).
The public document of 1.52.0 lists 112 operations, 22 of them added in this release and still in 1.65.0.
Operations added
| Operation | Summary | Scope | Released in | Phase 0 host |
|---|---|---|---|---|
GET /v1/event-filters | List event filters | webhooks:read | 1.52.0 | served |
POST /v1/event-filters | Create an event filter | webhooks:write | 1.52.0 | served |
GET /v1/event-filters/{filter_id} | Read an event filter | webhooks:read | 1.52.0 | served |
PATCH /v1/event-filters/{filter_id} | Update an event filter | webhooks:write | 1.52.0 | served |
DELETE /v1/event-filters/{filter_id} | Delete an event filter | webhooks:write | 1.52.0 | served |
GET /v1/event-types | List the event catalog | webhooks:read | 1.52.0 | served |
GET /v1/events | List the event log | events:read | 1.52.0 | served |
GET /v1/events/stream | Stream the Organization events | events:read | 1.52.0 | served |
GET /v1/events/{event_id} | Read an event | events:read | 1.52.0 | served |
GET /v1/jobs | List jobs | jobs:read | 1.52.0 | served |
GET /v1/jobs/{job_id} | Read a job | jobs:read | 1.52.0 | served |
POST /v1/jobs/{job_id}/cancel | Cancel a job | jobs:write | 1.52.0 | served |
POST /v1/jobs/{job_id}/result-url | Issue a URL of a job's result file | jobs:read | 1.52.0 | served |
GET /v1/pre-call-hooks | List pre-call hooks | hooks:read | 1.52.0 | served |
POST /v1/pre-call-hooks | Create a pre-call hook | hooks:write | 1.52.0 | served |
GET /v1/pre-call-hooks/{hook_id} | Read a pre-call hook | hooks:read | 1.52.0 | served |
PATCH /v1/pre-call-hooks/{hook_id} | Update a pre-call hook | hooks:write | 1.52.0 | served |
DELETE /v1/pre-call-hooks/{hook_id} | Delete a pre-call hook | hooks:write | 1.52.0 | served |
POST /v1/pre-call-hooks/{hook_id}/attest-phi | Attest a pre-call hook for PHI | hooks:write | 1.52.0 | served |
POST /v1/pre-call-hooks/{hook_id}/rotate-secret | Rotate the secret of a pre-call hook | hooks:write | 1.52.0 | served |
POST /v1/pre-call-hooks/{hook_id}/test | Send a synthetic request to a pre-call hook | hooks:write | 1.52.0 | served |
POST /v1/webhooks/{webhook_id}/replay | Replay the events of a time window to a Webhook subscription | webhooks:write | 1.52.0 | served |
Error codes added
event_filter_in_use, job_result_not_available, replay_in_progress
Event types added
agent.version.published, api_key.created, api_key.expiring, api_key.revoked, call.answered, call.created, call.ended, call.escalated, call.ringing, call.trace.ready, call.transferred, job.failed, job.succeeded, member.invited, member.joined, member.removed, member.role_changed, phone_number.routed, policy.error, policy.fired, policy.timeout, policy.version.activated, policy.version.published, pre_call_hook.degraded, pre_call_hook.recovered, recording.ready, tool.completed, tool.invoked, transcript.ready
Call event types added
pre_call.completed
Scopes added
events:read, hooks:read, hooks:write, jobs:read, jobs:write, webhooks:read, webhooks:write