Send a chat message
Sends a message to an active chat. Use application/json for text-only, or multipart/form-data to attach files. message may be omitted for a control-only request when cancel_current or stop_agent is true.
Authorizations
API token obtained from the Tokens endpoint or CLI device login. Include as Authorization: Bearer <token>. Requests made with a managed CLI session also include X-Strix-Workspace: <organization_id> to pin a process to the workspace it started in; recovery endpoints report the current workspace after a concurrent switch.
Path Parameters
Chat id.
Body
- Option 1
- Option 2
- Option 3
Send a message, or set cancel_current or stop_agent to true. Attach repos or images as context for the message.
Next instruction for the agent, in natural language.
1Cancel the in-flight agent turn before sending.
Park the target agent and its descendants (leaves first) instead of only cancelling the current turn. Parked agents resume when messaged again. Send with agent_id and no message to stop a subagent.
Additional connected repositories to attach as context.
Image URLs to attach to the message.
Deliver the message to this subagent instead of the chat's root agent.
Response
Message accepted.
The response is of type object.