Skip to main content
GET
Manage Inbox Thread
Fetches one thread with its full message list: thread_id, inbox_id, labels, timestamp, received_timestamp, sent_timestamp, senders, recipients, subject, preview, attachments and the messages themselves. For a single message use get_agentmail_inbox_message.

Example

First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. Your agent then reaches every endpoint through a few meta tools: search, list_categories, get_details and batch_quote are free, batch_use is billed per call. Setup per client is in Connect via MCP; the live tool list and what each call costs are on aisa.one/mcp.
Set this endpoint up in your agent →

Request contract

Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

Cost and request rules

Published reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
  • Default request reference estimate (USD): 0.012
  • Cost contract: explicit_zero
  • Settlement evidence source: request_snapshot

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

inbox_id
string
required

The ID of the inbox.

thread_id
string
required

ID of thread.

Query Parameters

limit
integer

Maximum number of messages to return. Cannot exceed 100. Limit of number of items returned.

page_token
string

Token returned by the previous response for retrieving the next, older page. Page token for pagination.

Response

Response with status 200

count
integer
required

Number of messages in this response page.

created_at
string<date-time>
required

Time at which thread was created.

inbox_id
string
required

The ID of the inbox.

labels
string[]
required

Labels of thread.

last_message_id
string
required

ID of last message in thread.

message_count
integer
required

Number of messages in thread.

messages
Message · object[]
required

Messages in this page, ordered by timestamp ascending. The first page contains the newest messages; follow next_page_token to retrieve older pages.

recipients
string[]
required

Recipients in thread. In format username@domain.com or Display Name <username@domain.com>.

senders
string[]
required

Senders in thread. In format username@domain.com or Display Name <username@domain.com>.

size
integer
required

Size of thread in bytes.

thread_id
string
required

ID of thread.

timestamp
string<date-time>
required

Timestamp of last sent or received message.

updated_at
string<date-time>
required

Time at which thread was last updated.

attachments
Attachment · object[]

Attachments in thread.

limit
integer

Maximum number of messages requested for this page.

next_page_token
string

Token for the next, older page of messages. Omitted when this page completes the thread.

preview
string

Text preview of last message in thread.

received_timestamp
string<date-time>

Timestamp of last received message.

sent_timestamp
string<date-time>

Timestamp of last sent message.

subject
string

Subject of thread.