Skip to main content
POST
Create Thread Message Handler

Headers

authorization
string | null

Path Parameters

thread_id
string<uuid>
required

Cookies

ks_uat
string | null

Body

application/json

Request to create a new thread message.

role
enum<string>
required

Role of the message author (USER, ASSISTANT, SYSTEM)

Available options:
USER,
ASSISTANT,
SYSTEM
content
ThreadMessageContent · object
required

Message content (text + citations)

message_id
string<uuid> | null

Optional caller-supplied ThreadMessage ID for idempotent creates.

details
ThreadMessageDetails · object | null

Message details (execution steps). Omit for user messages.

Response

Successful Response

Thread message response model.

id
string<uuid>
required

ThreadMessage ID

path_part_id
string<uuid>
required

PathPart ID

sequence
integer
required

Sequence number (from path_part.name)

role
enum<string>
required

Message role

Available options:
USER,
ASSISTANT,
SYSTEM
content
EnrichedThreadMessageContent · object
required

Message content

parent_path_id
string<uuid>
required

Thread's PathPart ID

materialized_path
string
required

Full materialized path from root

tenant_id
string<uuid>
required

Tenant ID

created_at
string<date-time>
required

Creation timestamp

updated_at
string<date-time>
required

Last update timestamp

details
ThreadMessageDetails · object | null

Message details (None when not requested via with_details)