Skip to main content
GET
Get message
Retrieve a single message by ID. For assistant messages where file search was used, the content includes source tracing fields per retrieved chunk: chunk_id, page, lines, and section. Use chunk_id to call the chunk endpoint for full Markdown provenance and the file_id of the source document.

Authorizations

Authorization
string
header
required

Your Seekr API key, sent in the Authorization header with no 'Bearer' prefix.

Headers

x-team-id
string | null

ID of the team to use for the request. If omitted, the request uses your personal workspace.

Path Parameters

thread_id
string
required

ID of the thread.

message_id
string
required

ID of the message.

Query Parameters

include_parts
boolean
default:false

If true, each message includes its parts.

expand_part_payloads
boolean
default:false

If true, each message part includes its full payload instead of a reference to it.

Response

Success

Thread message shape returned by the thread API.

parts are opt-in so existing clients keep the previous response shape by default.

thread_id
string
required

ID of the thread.

role
string
required

Role of the message author, such as user or assistant.

content
required

Content of the message.

id
string

ID of the message.

object
string
default:thread.message

Object type. Always thread.message.

created_at
string<date-time>

Time the resource was created, in ISO 8601 format.

parts
(MessageTextPart · object | MessageReasoningPart · object | MessageFilePart · object | MessageDataPart · object | MessageToolCallPart · object | MessageToolErrorPart · object | MessageToolResultPart · object)[] | null

Structured message parts, included when include_parts=true. Large payloads can be represented by stored-object references.

A text part persisted alongside a thread message.

agent_id
string | null

ID of the agent.

run_id
string | null

ID of the run.

meta_data
Meta Data · object

Key-value pairs you attach to the resource.

Last modified on July 31, 2026