---
title: "Cancel Agent Run"
method: POST
path: "/v1/agents/{agent_id}/messages/cancel"
tags: ["agents"]
---

# Cancel Agent Run

`POST /v1/agents/{agent_id}/messages/cancel`

Cancel runs associated with an agent. If run_ids are passed in, cancel those in particular.

Note to cancel active runs associated with an agent, redis is required.

## Path parameters

- `agent_id` string, required

## Request body

- CancelAgentRunRequest
  - `run_ids` string[], nullable — Optional list of run IDs to cancel

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/yu-code666/apis/letta-api.md) · [All operations](https://skmtc.net/yu-code666/apis/letta-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yu-code666/letta-api/revisions/6cec99480c13/schema)