List account events
/eventsAuthorization
bearerAuth Send Authorization: Bearer <token> with one of: an app session access token from /auth/verify-otp or /auth/refresh; an OAuth access token from /oauth/token issued for the API origin (its scopes are its permissions); or a personal access token starting with optima_pat_ (see /docs/personal-access-tokens). Personal access tokens cannot create or list tokens, revoke other tokens, sign out, or delete or restore the account. Content routes need the permission of their layer: audio:read/audio:write for recordings, turns:read/turns:write for turns, contacts, source signals, and events, and insights:read/insights:write for suggestions and session summaries; search and recall need turns:read and insights:read. A request without the permission, or for an account whose layer is turned off, returns 403 FORBIDDEN. See /docs/authentication#scopes.
In: header
Query Parameters
1 <= value <= 10025^(0|[1-9][0-9]{0,18})$Value in
- "account.created"
- "account.updated"
- "account.deleted"
- "account.restored"
- "contact.created"
- "contact.updated"
- "contact.deleted"
- "source.created"
- "source.updated"
- "source.deleted"
- "turn.created"
- "turn.updated"
- "turn.deleted"
- "run.published"
- "memory.created"
- "memory.updated"
- "memory.deleted"
- "conversation.created"
- "conversation.updated"
- "conversation.deleted"
- "suggestion.created"
- "suggestion.updated"
- "suggestion.deleted"
- "suggestion_profile.updated"
- "memory_context.updated"
- "pipeline.created"
- "pipeline.updated"
- "device_session.started"
- "device_session.joined"
- "device_session.left"
- "device_session.updated"
- "device_session.ended"
- "stream.created"
- "stream.updated"
- "personal_access_token.created"
- "personal_access_token.revoked"
- "workspace.retention_applied"
- "workspace.updated"
- "workspace.deleted"
Header Parameters
Send 1 to pin the documented API contract. If omitted, the latest version is selected.
"1"Value in
- "1"
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/events" \ -H "X-API-Version: 1"{ "success": true, "data": { "items": [ { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "schema_version": 1, "sequence": "string", "occurred_at": "2019-08-24T14:15:22Z", "account_id": "449e7a5c-69d3-4b8a-aaaf-5c9b713ebc65", "data": { "changed_fields": [ "string" ], "pipeline_id": "ec036e81-7903-4e4d-bbfa-ac8516341cf0", "source_id": "ae50a35c-df42-4eff-ba26-f8bc28d2af81", "run_id": "dded282c-8ebd-44cf-8ba5-9a234973d1ec", "revision": 1, "state_version": 1, "reason": "string" }, "type": "workspace.deleted", "resource": { "type": "workspace", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08" } } ], "cursor": "string" }}