---
title: "Cancel agent run"
method: POST
path: "/agent/runs/{run_id}/cancel"
tags: ["agent"]
---

# Cancel agent run

`POST /agent/runs/{run_id}/cancel`

Mark an asynchronous agent run as cancelled.

Required roles: All, App

## Path parameters

- `run_id` string, required

## Query parameters

- `principal_id` string

## Response `200`

Cancelled agent run

- AgentRun
  - `run_id` string, required
  - `thread_id` string
  - `workflow_type` string, required
  - `provider` 'ANTHROPIC_DIRECT' | 'BEDROCK' | 'VERTEX_AI', required
  - `execution_mode` 'LOCAL' | 'AGENTCORE', required
  - `status` string, required — Agent run status. Values are QUEUED, RUNNING, SUCCEEDED, FAILED, or CANCELLED.
  - `runtime_arn` string
  - `runtime_session_id` string
  - `mcp_session_id` string
  - `trace_id` string
  - `idempotency_key` string
  - `created_at` string, date-time
  - `started_at` string, date-time
  - `finished_at` string, date-time
  - `input` object — Original RunAgentInput. Used to reconstruct a thread's transcript on restore.
  - `parent_run_id` string, nullable — Run this run branched from within the thread (null for the thread root).
  - `result` object
  - `error` object

## Other responses

- `401` — Unauthorized
- `404` — Not Found

---

[API](https://skmtc.net/qlonolink/apis/qaip-apis.md) · [All operations](https://skmtc.net/qlonolink/apis/qaip-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qlonolink/qaip-apis/versions/f5f5994dfe05/schema)