Skip to main content
GET
Inboxes - Get Attachment
Fetches metadata for one attachment anywhere in a thread. Returns attachment_id, filename, size, content_type, content_disposition, content_id and a short-lived download_url with expires_at. The bytes are not inlined — fetch download_url before it expires. Ids come from the thread’s attachments array on get_agentmail_inbox_thread. The message-level twin is get_agentmail_inbox_message_attachment.

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

attachment_id
string
required

ID of attachment.

inbox_id
string
required

The ID of the inbox.

thread_id
string
required

ID of thread.

Response

Response with status 200

attachment_id
string
required

ID of attachment.

download_url
string
required

Signed HTTPS CDN URL to download the attachment bytes. Retrieve a fresh URL when needed rather than storing it permanently.

expires_at
string<date-time>
required

Time at which download_url and text_url (when present) expire. Retrieve the attachment again to obtain fresh URLs.

size
integer
required

Size of attachment in bytes.

content_disposition
enum<string>

Content disposition of attachment.

Available options:
inline,
attachment
content_id
string

Content ID of attachment.

content_type
string

Content type of attachment.

filename
string

Filename of attachment.

text_url
string

Signed HTTPS CDN URL to download extracted plain text, when available. Omitted when no extracted text is available. Expires at the same time as download_url.