Sign in

v1

latestOpenAPI 3.0.3MIT2026-07-17241338.5 KB
Agents

Dispatch an agent run

Dispatches a new AgentDispatchRun against the named stack. The agent will process the prompt in the context of the specified repository and branch.

post/api/orgs/{org}/agents/dispatch

Path parameters

orgstring required
Example:default

Organization slug

Request body

OR
OR
OR

Example request

{
  "agentDefinition": "aria-reviewer",
  "definitionRef": "aria-reviewer",
  "stackRef": "claude-code-stack",
  "agentStack": "claude-code-stack",
  "repository": "my-repo",
  "branch": "fix/auth-bug",
  "prompt": "Fix the failing tests in the auth module"
}

Response

Agent run dispatched

runNamestring

Name of the created AgentDispatchRun

statusstring

Example response

{
  "run": {
    "apiVersion": "kradle.a5c.ai/v1alpha1",
    "kind": "AgentStack",
    "metadata": {
      "name": "my-stack",
      "namespace": "kradle-org-default"
    }
  },
  "status": "dispatched"
}