v30

latestOpenAPI 3.0.3raw.githubusercontent.com2026-02-16162228.3 KB

Conversations

Create conversation

post/agents/{agentId}/conversations

Path parameters

agentIdstring required

The unique identifier of the agent

Request body

userIdentifierstring required

Unique identifier for the end-user (1-256 chars). Allowed characters: alphanumeric, underscore, hyphen, period, at symbol.

userContextobject

Optional context key-values for additional filtering/tenancy. Required when User Context status is ENABLED. Must be omitted when User Context status is DISABLED. Requests fail when User Context is UNSET.

Example request

{
  "userIdentifier": "user_123"
}

Response

Conversation created

idstring