Events

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, so process or store them. Use peek_events to look without consuming.

Returns {"events": [...], "count"}: each event has event_id, agent_id, event_type, payload and created_at, oldest first. An empty list means nothing is pending. Agents with a webhook receive events there instead.

get/v1/events

Request

  • Base URL: https://api.agentline.cloud
  • URL: https://api.agentline.cloud/v1/events
  • Auth: HTTP bearer

Query parameters

agent_idstring nullable

Only events for this agent (agt_... from list_agents). Omit for every agent on the account.

event_typestring nullable

Only events of this exact type, e.g. 'call.completed', 'call.failed', 'call.received' or 'sms.received'.

limitinteger

Most events to claim in this call, oldest first. Events past the limit stay queued for the next poll.

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.