Messages

List sent messages

Requires scope: read.

get/v1/messages

Request

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

Query parameters

limitinteger

Page size (1–100).

cursorstring

Opaque cursor from a previous page's next_cursor.

agent_idstring

Filter by agent id or name. A key tied to one agent always reads that agent's mail, and naming another agent is a 403.

thread_idstring

Filter by thread id.

qstring

Case-insensitive substring of the subject, body or recipient addresses. For word search across all mail, use GET /v1/search.

Response

A page of sent messages.

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.