List Events
Poll for telephony events from your AI agents.
Returns pending events such as call completions, transcripts, and failures. Events are consumed on retrieval (one-time read) — once polled, they are automatically deleted from the mailbox.
Your AI agent should call this endpoint periodically to receive notifications about completed calls and their transcripts.
Filters:
- agent_id: only events for a specific AI agent
- event_type: e.g. “call.completed”, “call.failed”
Authorizations
AgentLine API key. Get one via the email OTP flow (POST /v1/auth/otp then POST /v1/auth/verify). Pass as: Authorization: Bearer sk_live_...
Query Parameters
Filter events by AI agent ID
Filter by event type (e.g. 'call.completed', 'call.failed')
Maximum number of events to return (1-200)
x <= 200Response
Successful Response