Agents

Inbox summary

Requires scope: read. Unread count, thread and unread counts per folder and per label, and the time of the latest message.

get/v1/agents/{id}/inbox

Request

  • Base URL: https://api.mails.ai
  • URL: https://api.mails.ai/v1/agents/{id}/inbox
  • Auth: HTTP bearer

Path parameters

idstring required

Agent id or name.

Response

The agent's inbox summary.

agent_idstring required

The agent's id (agt_…), also when the path named it by name.

emailstring email required

The agent's API address: <name>@<slug>.mails.ai, or <name>@<your domain> for an agent created on a custom domain. A <slug>.mails.ai address is not an inbox: people write to the agent at its receiving_address, <name>.<slug>@in.mails.ai.

unread_countinteger required

Unread threads in the inbox folder.

last_message_atstring date-time nullable required

When a message last joined any of the agent's threads, in any folder, trash included. Null when the agent has no threads.

Changes

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