Skip to main content
GET
List messages
Returns all messages in a thread in chronological order. Use this after a run completes to read the agent’s response. When the agent used file search, each retrieved chunk’s source tracing fields are appended to the assistant message content: 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.

Query Parameters

limit
integer
default:20

Maximum number of results to return.

Required range: x >= 0
order
enum<string>
default:desc

Direction to sort the results. Options for order query param in list endpoints.

Available options:
asc,
desc
offset
integer
default:0

Number of results to skip.

Required range: x >= 0
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_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