Skip to main content
GET
/
v1
/
threads
/
{thread_id}
/
messages
List messages
curl --request GET \
  --url https://flow.seekr.com/v1/threads/{thread_id}/messages \
  --header 'Authorization: <api-key>'
[
  {
    "thread_id": "<string>",
    "role": "<string>",
    "content": "<string>",
    "id": "<string>",
    "object": "thread.message",
    "created_at": "2023-11-07T05:31:56Z",
    "parts": [
      {
        "type": "<string>",
        "text": "<string>",
        "id": "<string>",
        "metadata": {}
      }
    ],
    "agent_id": "<string>",
    "run_id": "<string>",
    "meta_data": {}
  }
]
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

Authorization Bearer Token

Headers

​
x-team-id
string | null

Path Parameters

​
thread_id
string
required

Query Parameters

​
limit
integer
default:20
Required range: x >= 0
​
order
enum<string>
default:desc

Options for order query param in list endpoints.

Available options:
asc,
desc
​
offset
integer
default:0
Required range: x >= 0
​
include_parts
boolean
default:false
​
expand_part_payloads
boolean
default:false

Response

Successful Response

​
thread_id
string
required
​
role
string
required
​
content
required
​
id
string
​
object
string
default:thread.message
​
created_at
string<date-time>
​
parts
(MessageTextPart · object | MessageReasoningPart · object | MessageFilePart · object | MessageDataPart · object | MessageToolCallPart · object | MessageToolErrorPart · object | MessageToolResultPart · object)[] | null

A text part persisted alongside a thread message.

​
agent_id
string | null
​
run_id
string | null
​
meta_data
Meta Data · object
Last modified on June 18, 2026