Skip to main content
GET
Manage Email Thread
Fetches one thread by id without naming an inbox: thread_id, inbox_id, labels, timestamp, received_timestamp, sent_timestamp, senders, recipients, subject, preview, attachments and messages. Because no inbox is named, this resolves against the whole account. Every AIsa caller shares one AgentMail account, so this reaches inboxes other callers created, so a thread id that is not yours still resolves — check the returned inbox_id. The scoped twin is get_agentmail_inbox_thread.

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 → Currently disabled.

Request contract

  • Method and path: GET /apis/v1/agentmail/threads/{thread_id}
  • Availability: disabled
This endpoint is disabled and cannot be called. Its historical request and schema details are retained for reference; pricing is not published.
  • Request URL template: https://api.aisa.one/apis/v1/agentmail/threads/{thread_id}
  • thread_id: path; required
  • limit: query; optional
  • page_token: query; optional
Complete OpenAPI definition Effective request declaration (including authentication and referenced schemas):

Cost and request rules

Historical archive: disabled, cannot be called, and no price is published.

Authorizations

Authorization
string
header
required

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

Path Parameters

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.