Create agent run
POST/v1/api/ai/runs
Body parameters
Responses
| Parameter | Type | Description |
|---|---|---|
approval | boolean | Whether this agent run requires approval before continuing |
branch | string | The branch this agent run should operate on (if not set, the repository default branch is used) |
flow_id | string | Optional flow ID to associate this agent run with |
moderequired | string | Mode of the agent run (analyze for read-only, write for modifications) |
promptrequired | string | The prompt to give to the agent describing the task to perform |
repositoryrequired | string | The git repository URL the agent will work on (https or ssh format) |
runtime_idrequired | string | The runtime ID to execute the agent run on |
shared | boolean | Whether to share this agent run publicly |
Response samples
200
{
"approval": false,
"approved_at": "string",
"branch": "string",
"error": "string",
"flow_id": "string",
"id": "string",
"inserted_at": "string",
"language": "javascript",
"language_version": "string",
"mode": "analyze",
"prompt": "string",
"repository": "string",
"runtime_id": "string",
"shared": false,
"status": "pending",
"updated_at": "string",
"user_id": "string"
}