v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-304917042.1 MB
runtime v2

Get or create a v2 conversation

post/v1/v2/conversations

Request body

end_user_idstring uuid required
channelstring
assistant_idstring uuid nullable
assistant_revision_idstring uuid nullable
team_idstring uuid nullable
team_revision_idstring uuid nullable
channel_subtypestring nullable
origin'inbound' | 'outbound' nullable
session_type'live' | 'test' | 'simulation'
external_idstring nullable
org_phone_number_idstring uuid nullable
subjectstring nullable
metadataobject nullable
tool_input_overridesobject nullable
context_variablesobject nullable

Response

Successful Response

idstring uuid required
organization_idstring uuid required
end_user_idstring uuid required
channelstring required
channel_subtypestring nullable
originstring nullable
statusstring required
session_typestring required
assistant_idstring uuid nullable
assistant_revision_idstring uuid nullable
team_idstring uuid nullable
team_revision_idstring uuid nullable
external_idstring nullable
subjectstring nullable
tool_input_overridesobject nullable
created_atstring date-time required
updated_atstring date-time required