Error
A valid request URL is required to generate request examples{
"thread": {},
"message_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"user_message": {},
"dispatched": "<array>",
"skipped": "<array>",
"failed": "<array>"
}API Reference
Create thread
Creates a new thread and sends the first message. Supports both direct (single agent_id) and group (agent_ids array) creation. For group threads, dispatches to all running agents and returns three-array response (dispatched/skipped/failed). Max 8 agents per group.
POST
/
chat
/
threads
Error
A valid request URL is required to generate request examples{
"thread": {},
"message_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"user_message": {},
"dispatched": "<array>",
"skipped": "<array>",
"failed": "<array>"
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Single agent UUID (creates direct thread)
Multiple agent UUIDs (creates group thread)
Maximum array length:
8Designate a lead agent for collaborative group threads. Must be one of the agent_ids. When set, only the lead agent receives dispatch with collaborator context. Other agents serve as queryable collaborators.