Dynamiq
Runs

Cancel a run

Cancels a run that has not reached a terminal state. Cancelling an already completed, failed, or canceled run is a no-op and still returns 200.

POST
/v1/runs/{run_id}/cancel

Authorization

accessKey
AuthorizationBearer <token>

Organization or project Access Key created in the Dynamiq console. Used for deployed-app (Runs API), AI Gateway, traces collector, and management API requests. Send as Authorization: Bearer <access-key>.

In: header

Path Parameters

run_id*string

Run UUID.

Response Body

application/json

application/json

application/json

curl -X POST "https://example.com/v1/runs/497f6eca-6276-4993-bfeb-53cbbbba6f08/cancel"
{
  "message": "canceled"
}
{
  "error": {
    "code": "unauthorized",
    "message": "Unauthorized"
  }
}
{
  "error": {
    "code": "not_found",
    "message": "Not Found"
  }
}

Get a run

Returns a single run. If the run has unresolved human-feedback or approval requests, its status is reported as `awaiting_input` and the pending requests are listed in `input_requests`.

Send input to a run

Answers a pending human-feedback or approval request of a run. Only runs in `started` or `paused` status accept input; a paused run is resumed from its latest checkpoint first. The `request_id` must match the `id` of a pending request from the run's `input_requests` (or the corresponding `agent.human_feedback.requested` / `approval_request.created` event).