Skip to main content
POST
Error

Authorizations

Authorization
string
header
required

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.

Body

Start a new chat. application/json is shown here. To attach files, send multipart/form-data instead.

message
string
required

First instruction for the agent, in natural language.

repos
object[]

Connected repositories to attach as context for the chat.

images
object[]

Image URLs to attach to the message.

domain_ids
string<uuid>[]

Verified organization domain ids to scope the chat to. Narrowing only: the agent is authorized to test only these domains (and their subdomains). Omit for organization-wide authorization.

Response

Chat started.

The response is of type object.