Create a new thread and immediately ask a query in a single request. This endpoint combines thread creation and turn creation to reduce round trips.
Supports synchronous and background processing modes. Streaming is not supported.If you need to use streaming mode then directly use the endpoint to create a turn within a thread
Note: chat_setting_id has been deprecated, now use agent_id instead, chat_settings_id is still supported for back-compatibility purposes. If no agent_id nor chat_setting_id is provided, the default agent for the company is used.
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Combined serializer for creating a thread and immediately creating a turn (answer).
This serializer composes the existing thread and answer serializers to maximize code reuse and maintain consistent validation logic.
Note: The 'stream' parameter is not supported for this endpoint.
Thread name
255ID of the agent to use. If not provided, uses the default agent for the company.
DEPRECATED: Use 'agent_id' instead. ID of the chat setting to use. If not provided, uses the default agent for the company.
Enable ephemeral mode
The user's query
Name of tool to force use
ID of a suggested query
Name of MCP server to restrict tools to
Skip tool calls and return final answer immediately
Process asynchronously and return immediately
Additional system prompt instructions
5000Maximum reasoning steps
1 <= x <= 20JSON schema specifying response structure
Workspaces to search for documents
Specific files to include
Specific tags to include
Include user's private workspace
Include company's workspace
Final answer returned synchronously.
running - runningcompleted - completedfailed - failedcancelled - cancelledcancelling - cancellingrunning, completed, failed, cancelled, cancelling