Events

Peek Events

Peek at pending telephony events without consuming them.

Returns a preview of queued events (call completions, transcripts) without removing them from the mailbox. Useful for checking if there are events to process before committing to retrieve them.

Returns {"pending_count", "events"}: pending_count counts every queued event for the account (or agent_id); events lists event_id, agent_id, event_type and created_at, without payloads. Call poll_events to get the payloads.

get/v1/events/peek

Request

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

Query parameters

agent_idstring nullable

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

limitinteger

Most events to list, oldest first. Does not change pending_count.

Response

Successful Response

unknown required

Changes

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