---
title: "Changes to Cancel agent run"
method: POST
path: "/agent/runs/{run_id}/cancel"
---

# Changes to Cancel agent run

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

> Every recorded change to this operation, newest first.

## Timeline

Changed in 10 of 76 revisions.

- **2026-09-17** `2489c6f1a9d8`: 10 info
- **2026-09-01** `b065e544fec5`: 1 warning, 4 info
- **2026-09-01** `26fef6564ef0`: 3 breaking, 2 info
- **2026-08-26** `312537b55e9d`: 3 info
- **2026-08-26** `557741b7aba5`: 1 info
- **2026-08-19** `90c0a301b016`: 1 warning
- **2026-08-17** `c874961c9519`: 1 breaking, 1 info
- **2026-07-10** `05d4c3bc46f2`: 3 info
- **2026-04-30** `7c778f65dca5`: 1 warning
- **2026-03-27** `d5bad61b1542`: 1 info

## Changes

- **2026-09-17** `2489c6f1a9d8`: 10 info
  - added the non-success response with the status `502`
  - added the optional property `error/code` to the response with the `401` status
  - added the optional property `error/code` to the response with the `404` status
  - added the optional property `error/details` to the response with the `401` status
  - added the optional property `error/details` to the response with the `404` status
  - added the optional property `error/request_id` to the response with the `401` status
  - added the optional property `error/request_id` to the response with the `404` status
  - added the optional property `error/retryable` to the response with the `401` status
  - added the optional property `error/retryable` to the response with the `404` status
  - added the optional property `request_id` to the response with the `202` status
- **2026-09-01** `b065e544fec5`: 1 warning, 4 info
  - added the new `OPENAI` enum value to the `provider` response property for the response status `202`
  - the `trace_id` response's property pattern `^[0-9a-f]{32}$` was added for the status `202`
  - added the required property `context_start_run_id` to the response with the `202` status
  - added the required property `context_truncated` to the response with the `202` status
  - added the required property `input_history_mode` to the response with the `202` status
- **2026-09-01** `26fef6564ef0`: 3 breaking, 2 info
  - removed the required property `context_start_run_id` from the response with the `202` status
  - removed the required property `context_truncated` from the response with the `202` status
  - removed the required property `input_history_mode` from the response with the `202` status
  - removed the `OPENAI` enum value from the `provider` response property for the response status `202`
  - the `trace_id` response's property pattern `^[0-9a-f]{32}$` was removed for the status `202`
- **2026-08-26** `312537b55e9d`: 3 info
  - added the required property `context_start_run_id` to the response with the `202` status
  - added the required property `context_truncated` to the response with the `202` status
  - added the required property `input_history_mode` to the response with the `202` status
- **2026-08-26** `557741b7aba5`: 1 info
  - the `trace_id` response's property pattern `^[0-9a-f]{32}$` was added for the status `202`
- **2026-08-19** `90c0a301b016`: 1 warning
  - added the new `OPENAI` enum value to the `provider` response property for the response status `202`
- **2026-08-17** `c874961c9519`: 1 breaking, 1 info
  - removed the success response with the status `200`
  - added the success response with the status `202`
- **2026-07-10** `05d4c3bc46f2`: 3 info
  - added the new optional `query` request parameter `principal_id`
  - added the optional property `input` to the response with the `200` status
  - added the optional property `parent_run_id` to the response with the `200` status
- **2026-04-30** `7c778f65dca5`: 1 warning
  - added the new `VERTEX_AI` enum value to the `provider` response property for the response status `200`
- **2026-03-27** `d5bad61b1542`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/qlonolink/apis/qaip-apis/docs/agent/runs/:run_id/cancel/post.md) - [API](https://skmtc.dev/qlonolink/apis/qaip-apis.md) - [Page](https://skmtc.dev/qlonolink/apis/qaip-apis/changes/agent/runs/:run_id/cancel/post)