Stop a running run | AgentRouter | Developer Documentation

{
  "object": null,
  "run_id": "string",
  "status": "READY",
  "tool_id": "string",
  "tool_version": "string",
  "provider": "string",
  "input": null,
  "session_id": "string",
  "caller": {
    "type": "api_key",
    "name": "string"
  },
  "channel": "http",
  "created_at": "string",
  "started_at": "string",
  "completed_at": "string",
  "latency_ms": 1,
  "replayed": true,
  "stoppable": true,
  "provider_response": {
    "http_status": 1,
    "outcome": "success",
    "status": "string",
    "request_id": "string",
    "task_id": "string"
  },
  "error": {
    "code": "string",
    "message": "string",
    "origin": "provider",
    "retryable": true,
    "details": {
      "body": "string",
      "truncated": true
    }
  },
  "billing": {
    "status": "none",
    "reason": "charged",
    "currency": null,
    "pricing_version": "string",
    "price_multiplier": "string",
    "promotion_id": "string",
    "max_cost_usd": "0.0035",
    "reserved_usd": "0.0035",
    "base_charge_usd": "string",
    "customer_charge_usd": "0.0035",
    "customer_refund_usd": "0.0035",
    "net_charge_usd": "0.0035",
    "charge_is_new": true,
    "usage": {
      "unit": "string",
      "quantity": "string",
      "status": "known"
    }
  },
  "result": {
    "available": true,
    "expired": true,
    "bytes": 1,
    "expires_at": "string",
    "url": "string",
    "inline": true
  },
  "next_cursor": "string",
  "hints": [
    {
      "code": "string",
      "message": "string",
      "params": {}
    }
  ],
  "output": null
}

Only for tools whose describe says execution.stoppable. A run stopped before completion is not charged.

Authentication

AuthorizationBearer

An AgentRouter API key or an OAuth access token issued to an MCP host or the CLI.

Path parameters

run_idstringRequiredformat: "^run_[a-f0-9]{24}$"

Response

The run, now STOPPING or STOPPED

objectany

run_idstring

statusenum

tool_idstring

tool_versionstring

providerstring

inputany

The submitted tool input

session_idstring or null

callerobject

channelenum

Allowed values:

created_atstring or null

started_atstring or null

completed_atstring or null

latency_msinteger or null

replayedboolean

True when an idempotency key returned an existing run.

stoppableboolean

provider_responseobject

errorobject or null

billingobject

resultobject

next_cursorstring or null

Pass back as the tool’s cursor input for the next page (a new billed call).

hintslist of objects

outputany

The provider's output exactly as returned

Errors

404

Not Found Error

409

Conflict Error