Messages

List messages across inboxes

Messages of every inbox the key can see, newest first (an inbox-scoped key: its inbox only). Each message has its inbox_id. The filters of GET /v1/inboxes/:id/messages except promotions, the same cursor paging, and the same screening of held and unscreened mail. SDK messages.listAll() / messages.list_all(), MCP list_messages without inbox_id.

Permission: messages:read.

get/v1/messages

Request

  • Base URL: https://api.agentboxd.com
  • URL: https://api.agentboxd.com/v1/messages
  • Auth: HTTP bearer

Query parameters

cursorstring
limitinteger
labelsstring
is_read'true' | 'false'
direction'inbound' | 'outbound'
include_blocked'true' | 'false'
channel'agent' | 'email' | 'mixed'
type'message' | 'task' | 'event'
screening'screened' | 'pending' | 'held' | 'released'
status'queued' | 'sent' | 'delivered' | 'bounced' | 'complained' | 'failed' | 'received'
include_unscreened'true' | 'false'
include_held'true' | 'false'

Response

OK

object required

Changes

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