Skip to main content
POST
Required scope: write

Request body

CreateConversationRequest
object
Optional metadata object
string
Optional title (defaults to ‘New chat’)
string
Optional workflow ID (defaults to ‘support_concierge’)

Response

Conversation
string
Archive timestamp (RFC3339), if soft-deleted
string
required
Creation timestamp (RFC3339)
string
required
Unique conversation ID
object
required
Arbitrary metadata
string
Linked reasoning session ID
string
required
Tenant (organization) that owns this conversation
string
required
Human-readable title
string
required
Last update timestamp (RFC3339)
string
Optional user who created the conversation
string
required
Workflow ID controlling agent behavior

Status codes