Skip to main content
POST
/
agents
/
{agent_id}
/
runs
Trigger an agent run
curl --request POST \
  --url https://api.scrums.com/v1/agents/{agent_id}/runs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "input": {
    "prompt": "Summarise sprint velocity for Q1 2026."
  },
  "triggered_by": "USR-26-000044"
}
'
{
  "data": {
    "id": "RUN-26-001812",
    "agent_id": "AGT-26-000012",
    "service_line_id": "LIN-26-091844",
    "status": "running",
    "input": {
      "prompt": "Summarise sprint velocity for Q1 2026."
    },
    "output": null,
    "tokens_used": null,
    "duration_ms": null,
    "triggered_by": "USR-26-000044",
    "started_at": "2026-04-15T10:22:00Z",
    "completed_at": null
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
agent_id
string
required

The unique identifier of the agent (e.g. AGT-26-000012).

Pattern: ^AGT-

Body

application/json
​
input
object
required
Example:
{
  "prompt": "Summarise sprint velocity for Q1 2026."
}
​
triggered_by
string
required
Pattern: ^USR-
Example:

"USR-26-000044"

Response

The newly created agent run.

​
data
object
Last modified on April 15, 2026