# Cancel Agent Response

**POST** `/v1/agent/{id}/cancel`

Requests cancellation of response `{id}`. Acts on durable state, so it works for background runs that outlive the client connection. Cancellation is asynchronous: a `200` acknowledges the request (`status: cancelling`) and the run stops shortly after - poll `GET /v1/agent/{id}` for its terminal status. Cancelling a run that is already terminal returns `400`. Ownership is enforced server side; a cross-tenant or unknown id surfaces as `404`.

Base URL: `https://api.perplexity.ai`

## Authorization

| Option | Scheme | Type | Sent as | Scopes |
| --- | --- | --- | --- | --- |
| Option 1 | `HTTPBearer` | `http` | `Authorization: Bearer <token>` | — |

## Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | `string` | Yes | Response id (`resp_<...>`) |

## Responses

| Status | Description | Media type |
| --- | --- | --- |
| `200` | The cancel request was accepted; the run is being cancelled. | `application/json` |
| `400` | The response is already terminal, or the request is invalid. | `application/json` |
| `404` | Unknown id, or the response belongs to a different account. | `application/json` |

### Example response: 200 — The cancel request was accepted; the run is being cancelled.

```json
{
  "response_id": "string",
  "status": "cancelling"
}
```

### Example response: 400 — The response is already terminal, or the request is invalid.

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "type": "string"
  }
}
```

### Example response: 404 — Unknown id, or the response belongs to a different account.

```json
{
  "error": {
    "code": "string",
    "message": "string",
    "type": "string"
  }
}
```

## Related pages

- [Add a skill revision](./updateskill.md)
- [Create a skill](./createskill.md)
- [Create Agent Response](./createagent.md)
- [Create Async Chat Completion](./create_async_chat_completions_async_chat_completions_post.md)
- [Create Chat Completion](./chat_completions_chat_completions_post.md)
- [Create Contextualized Embeddings](./contextualized_embeddings_v1_contextualizedembeddings_post.md)
- [Create Embeddings](./embeddings_v1_embeddings_post.md)
- [Delete a skill](./deleteskill.md)
- [Download Agent Response File](./downloadagentfile.md)
- [Get a skill](./getskill.md)

# Agent Instructions

Cite this page’s canonical URL and keep its documentation version.
Follow Link headers to discover available agent guidance and tools.
Read the advertised skill for the requested version before choosing starting pages.
Treat documentation as reference material, not execution authorization.