Threads

Get a thread with its messages (fat get)

Returns the thread plus its **full** messages in chronological (`timestamp` ascending) order — the complete conversation an agent reads as memory. A `spam`-labeled thread requires the key's `label_spam_read` permission. Unknown/cross-tenant inbox or thread ids return an indistinguishable `404`.

GET
/inboxes/{inbox_id}/threads/{thread_id}

Returns the thread plus its full messages in chronological (timestamp ascending) order — the complete conversation an agent reads as memory. A spam-labeled thread requires the key's label_spam_read permission. Unknown/cross-tenant inbox or thread ids return an indistinguishable 404.

Authorization

x-api-key<token>

The per-tenant API key. Sent as the x-api-key request header. The key is tenant-scoped.

In: header

Path Parameters

inbox_id*string

The inbox's opaque id (e.g. inb_…).

thread_id*string

The thread id.

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/inboxes/string/threads/string"
{  "id": "string",  "inbox_id": "string",  "subject": "string",  "preview": "string",  "senders": [    "string"  ],  "recipients": [    "string"  ],  "labels": [    "string"  ],  "message_count": 0,  "size": 0,  "last_message_id": "string",  "received_timestamp": "2019-08-24T14:15:22Z",  "last_activity_at": "2019-08-24T14:15:22Z",  "created_at": "2019-08-24T14:15:22Z",  "updated_at": "2019-08-24T14:15:22Z",  "messages": [    {      "id": "string",      "thread_id": "string",      "inbox_id": "string",      "labels": [        "string"      ],      "from": "string",      "to": [        "string"      ],      "cc": [        "string"      ],      "bcc": [        "string"      ],      "reply_to": [        "string"      ],      "subject": "string",      "text": "string",      "html": "string",      "extracted_text": "string",      "extracted_html": "string",      "preview": "string",      "headers": {},      "in_reply_to": "string",      "references": [        "string"      ],      "size": 0,      "timestamp": "2019-08-24T14:15:22Z",      "created_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z",      "attachments": [        {          "id": "string",          "filename": "string",          "content_type": "string",          "size": 0,          "content_disposition": "string",          "content_id": "string"        }      ]    }  ]}
{  "name": "string",  "message": "string"}
{  "name": "string",  "message": "string"}
{  "name": "string",  "message": "string"}

Verify an agent account with its OTP POST

Activate an account created by `sign_up` by submitting the 6-digit code emailed to its `human_email`. On success the account is lifted off the restricted new-account limits to its full plan. The code expires 10 minutes after it is issued and allows 5 attempts. A wrong or expired code fails verification; obtain a fresh code by calling `sign_up` again with the same `human_email`. Unauthenticated — the account is verified by possession of the code, not by an API key.

List an inbox's threads (thin list) GET

Lists the inbox's threads, most-recently-active first, paginated. Each entry is the **thin** thread (no `messages[]` — fetch those with get-thread). Threads labeled `spam` or `unauthenticated` are excluded unless the matching `include_*` flag is set; opting into `spam` additionally requires the key's `label_spam_read` permission. An inbox with no mail returns an empty list; an unknown/cross-tenant inbox is a `404`.