threads

Read a conversation

Returns the conversation's metadata and its messages, with bodies and attachment metadata. Each message has direction (received or sent), timestamp, and the fields of received or sent detail.

The first page holds the newest messages, oldest first within the page; next_cursor fetches older ones. Order follows Cherami's receipt and send times, not the senders' Date headers. Counts describe the whole conversation.

Attachment bytes aren't included: download a received file, or read sent detail for a sent file's base64 content.

Received messages that aren't ready, or failed, aren't part of a conversation; read them through the message endpoints.

get/v1/threads/{thread_id}

Request

  • Base URL: https://cherami.to
  • URL: https://cherami.to/v1/threads/{thread_id}
  • Auth: HTTP bearer

Path parameters

thread_idstring required

Cherami resource ID returned by the API.

Query parameters

limitinteger

Results per page.

cursorstring

next_cursor from the previous page. Keep the URL, filters and order unchanged.

Response

Success.

idstring required

Cherami resource ID.

inbox_idstring required

Cherami resource ID.

subjectstring nullable required
last_activity_atstring date-time required

UTC timestamp with milliseconds.

message_countinteger required
received_countinteger required
accepted_countinteger required
rejected_countinteger required
unknown_countinteger required
next_cursorstring nullable required

Changes

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