Events

List events

Requires scope: read.

get/v1/events

Request

  • Base URL: https://api.mails.ai
  • URL: https://api.mails.ai/v1/events
  • Auth: HTTP bearer

Query parameters

limitinteger

Page size (1–100).

cursorstring

Opaque cursor from a previous page's next_cursor.

event_typestring

Filter by exact event type.

agent_idstring

Filter by agent id or name.

sincestring date-time

Only events created at or after this time: an ISO 8601 time such as 2026-10-05T07:00:00Z or 2026-10-05T16:00:00+09:00, or a date (2026-10-05, midnight UTC). A time with no offset is UTC, and its seconds and milliseconds may be left out. Any other value answers 400 invalid_param_value. The event stream's since is different: a position the stream gave, or an event id.

Response

A page of typed events.

has_moreboolean required

True when more items follow this page: pass next_cursor as cursor to get them.

next_cursorstring

Pass as cursor to fetch the next page. Absent on the last page.

Changes

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