Skip to content
For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
Primary navigation

Suggested
Overview Models Agents Tools Audio & voice Production API reference

Webhooks

Create Webhook Endpoint
webhooks.create(**kwargs) -> WebhookEndpointWithSecret
POST
/webhook_endpoints
Delete Webhook Endpoint
webhooks.delete(webhook_endpoint_id) -> DeletedWebhookEndpoint
DELETE
/webhook_endpoints/{webhook_endpoint_id}
List Webhook Endpoints
webhooks.list(**kwargs) -> SyncCursorPage[WebhookEndpoint]
GET
/webhook_endpoints
Retrieve Webhook Endpoint
webhooks.retrieve(webhook_endpoint_id) -> WebhookEndpoint
GET
/webhook_endpoints/{webhook_endpoint_id}
Rotate Webhook Endpoint Signing Secret
webhooks.rotate_secret(webhook_endpoint_id, **kwargs) -> WebhookEndpointWithSecret
POST
/webhook_endpoints/{webhook_endpoint_id}/rotate_secret
Test Webhook Endpoint
webhooks.test(webhook_endpoint_id, **kwargs) -> WebhookEndpointTestResult
POST
/webhook_endpoints/{webhook_endpoint_id}/test
Unwrap
webhooks.unwrap()
Function
Update Webhook Endpoint
webhooks.update(webhook_endpoint_id, **kwargs) -> WebhookEndpoint
POST
/webhook_endpoints/{webhook_endpoint_id}
Models
class AgentEnvironmentExpiredWebhookEvent: …

Sent when an agent environment expires and can no longer resume from a snapshot.

class AgentEnvironmentFailedWebhookEvent: …

Sent when setup fails for a prewarmed OpenAI-hosted environment before it is attached to a session.

class AgentEnvironmentReadyWebhookEvent: …

Sent when a prewarmed OpenAI-hosted environment finishes setup before being attached to a session.

class AgentEnvironmentSuspendedWebhookEvent: …

Sent when an agent environment is suspended and can resume from a snapshot.

class AgentSessionActionRequiredWebhookEvent: …

Sent when an agent session requires an action. Retrieve the session for action details.

class AgentSessionCreatedWebhookEvent: …

Sent when an agent session is created.

class AgentSessionFailedWebhookEvent: …

Sent when an agent session fails.

class AgentSessionIdleWebhookEvent: …

Sent when an agent session becomes idle.

class AgentSessionInProgressWebhookEvent: …

Sent when an agent session enters the in-progress state.

class BatchCancelledWebhookEvent: …

Sent when a batch API request has been cancelled.

class BatchCompletedWebhookEvent: …

Sent when a batch API request has been completed.

class BatchExpiredWebhookEvent: …

Sent when a batch API request has expired.

class BatchFailedWebhookEvent: …

Sent when a batch API request has failed.

class DeletedWebhookEndpoint: …
class EvalRunCanceledWebhookEvent: …

Sent when an eval run has been canceled.

class EvalRunFailedWebhookEvent: …

Sent when an eval run has failed.

class EvalRunSucceededWebhookEvent: …

Sent when an eval run has succeeded.

class FineTuningJobCancelledWebhookEvent: …

Sent when a fine-tuning job has been cancelled.

class FineTuningJobFailedWebhookEvent: …

Sent when a fine-tuning job has failed.

class FineTuningJobSucceededWebhookEvent: …

Sent when a fine-tuning job has succeeded.

class LiveCallIncomingWebhookEvent: …

Deprecated: use live.transport.incoming. Retained for existing subscriptions during migration; new subscriptions to this event are not allowed. Sent when an incoming API SIP session is available for Live acceptance. The same pending session can also emit realtime.call.incoming; the first successful Realtime or Live accept endpoint selects the runtime surface.

class LiveTransportIncomingWebhookEvent: …

Sent when an incoming API SIP session is available for Live acceptance. The same pending session can also emit realtime.call.incoming; the first successful Realtime or Live accept endpoint selects the runtime surface.

class RealtimeCallIncomingWebhookEvent: …

Sent when an incoming API SIP session is available for Realtime acceptance. The same pending session can also emit live.transport.incoming; the first successful Realtime or Live accept endpoint selects the runtime surface.

class ResponseCancelledWebhookEvent: …

Sent when a background response has been cancelled.

class ResponseCompletedWebhookEvent: …

Sent when a background response has been completed.

class ResponseFailedWebhookEvent: …

Sent when a background response has failed.

class ResponseIncompleteWebhookEvent: …

Sent when a background response has been interrupted.

class SafetyAlertCreatedWebhookEvent: …

Sent when an approved safety alert is available for an API project.

class SafetyDeactivationIssuedWebhookEvent: …

Sent when a deactivation is issued for a safety identifier in your organization.

class SafetyOrgAlertCreatedWebhookEvent: …

Sent when an approved safety alert is available for an enterprise workspace.

class SafetyWarningIssuedWebhookEvent: …

Sent when a warning is issued for a safety identifier in your organization.

class WebhookEndpoint: …
class WebhookEndpointList: …
class WebhookEndpointTestResult: …
class WebhookEndpointWithSecret: …
class WebhookEventTypeList: …

WebhooksEvent Types

List Webhook Event Types
webhooks.event_types.list() -> WebhookEventTypeList
GET
/webhook_event_types