> This page is for version v2026-02-09 (default).
> For other versions, use one of these documentation indexes:
> - v2026-02-09 (default): https://docs.extend.ai/2026-02-09/llms.txt
> - v2025-04-21: https://docs.extend.ai/2025-04-21/llms.txt
> - v2024-12-23: https://docs.extend.ai/2024-12-23/llms.txt

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.extend.ai/llms.txt
> Use this file to discover all available pages before exploring further.
>
> ## API version
> The current API version is `2026-02-09`, served at the site root (no version prefix in URLs).
> If this page URL contains `/2025-04-21/` or `/2024-12-23/`, you are reading an older API version.
> Prefer the current docs at https://docs.extend.ai/llms.txt unless the user explicitly needs that older version.
> Do not treat older-version pages as the source of truth for new integrations.

# Delete Processor Run

DELETE https://api.extend.ai/processor_runs/{id}

Delete a processor run and all associated data from Extend. This operation is permanent and cannot be undone.

This endpoint can be used if you'd like to manage data retention on your own rather than automated data retention policies. Or make one-off deletions for your downstream customers.


Reference: https://docs.extend.ai/api-reference/endpoints/legacy/delete-processor-run

## Authentication

- `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Servers

- `https://api.extend.ai` (Production, default)
- `https://api.us2.extend.app` (Production US2)
- `https://api.eu1.extend.ai` (Production EU1)

## Request

### Path parameters

- `id` (string, required) — The ID of the processor run to delete. Example: `"exr_Xj8mK2pL9nR4vT7qY5wZ"`

### Headers

- `x-extend-api-version` ("2026-02-09", optional, default: 2026-02-09) — API version to use for the request. If you're using an SDK, you can ignore this parameter. If you are not using an SDK and do not specify a version, you will either receive a `400 Bad Request` or be set to a previous legacy version. See [API Versioning](https://docs.extend.ai/2026-02-09/api-reference/api-versioning) for more details.
- `x-extend-workspace-id` (string, optional) — The workspace ID to target. **Required** when using an organization-scoped API key; optional for workspace-scoped keys (the key is already tied to a workspace). See [Authentication](https://docs.extend.ai/2026-02-09/api-reference/authentication) for details on API key scopes.

## Response

### 200

Successfully deleted processor run

- `success` (boolean, required)
- `documentProcessorRunId` (string, required) — The ID of the deleted processor run
- `message` (string, required) — Confirmation message

## Errors

### 404 Not Found Error

Processor run not found

- `code` (string, required) — Error code identifying the type of error
- `message` (string, required) — Human-readable error message
- `requestId` (string, required) — Unique request identifier for support purposes
- `retryable` (boolean, required) — Whether the request can be retried

### 500 Internal Server Error

Internal server error

- `code` (string, required) — Error code identifying the type of error
- `message` (string, required) — Human-readable error message
- `requestId` (string, required) — Unique request identifier for support purposes
- `retryable` (boolean, required) — Whether the request can be retried

## Examples

**Response**

```json
{
  "success": true,
  "documentProcessorRunId": "exr_Xj8mK2pL9nR4vT7qY5wZ",
  "message": "Document processor run data has been successfully deleted."
}
```