Skip to main content
POST
Create Agent Conversation

Authorizations

Authorization
string
header
required

JWT in Authorization header. 'Bearer ' prefix optional.

Body

application/json
workspace_id
string<uuid> | null

Workspace that scopes the conversation

project_id
string<uuid> | null

Optional project that scopes the conversation

share_id
string<uuid> | null

Optional share link that scopes the conversation

conversation_id
string<uuid> | null

Existing conversation to resume

title
string | null

Optional conversation title

Response

Successful Response

id
string<uuid>
required

Conversation ID

workspace_id
string<uuid>
required

Workspace that scopes the conversation

user_id
string<uuid>
required

User that owns the conversation

status
enum<string>
required

Conversation status

Available options:
active,
archived
last_activity_at
string<date-time>
required

Last timestamp for activity inside the conversation

created
string<date-time>
required

Creation timestamp

updated
string<date-time>
required

Last update timestamp

project_id
string<uuid> | null

Project that scopes the conversation

share_id
string<uuid> | null

Share link that scopes the conversation

title
string | null

Conversation title

has_active_run
boolean
default:false

Whether the conversation has a non-terminal agent run