Skip to main content
POST
Create message

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

include_parts
boolean
default:false

If true, each message includes its parts.

Body

application/json

Pydantic model for creating a thread message request.

Attributes: role (str): The role of the message sender. content (Union[str, list[InputMessage], list[OutputMessage]]): The content of the message. meta_data (Optional[dict[str, Any]]): Optional metadata dictionary.

role
enum<string>
required

Role of the message author. One of system, developer, user, assistant, or tool.

Available options:
user,
system,
tool,
developer,
assistant
content
required

Message content, as nonempty text or a nonempty list of structured text, image, or file input items.

Maximum string length: 32768
meta_data
Meta Data · object

Key-value pairs you attach to the resource.

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