API referenceAgents and workflowsWorkspaces
Start a repo-bound chat under the workspace: mode=agent spawns a single-agent run, mode=team an agent team. The repo is cloned into the agent's workspace; results ship as commits pushed to the default branch.
Requires the workspaces:chat permission.
AuthorizationBearer <token>
An access token from this zone's POST /oauth/token, or a session token from POST /api/v1/auth/login. Send it as Authorization: Bearer <token>.
In: header
Path Parameters
id*string
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/api/v1/workspaces/string/chats" \ -H "Content-Type: application/json" \ -d '{ "mode": "string", "prompt": "string" }'{ "created_at": "2019-08-24T14:15:22Z", "kind": "string", "ref_id": "58ed4a6c-926f-4b2f-b688-ecd86db2ed34", "seq": "string", "title": "string"}