---
title: "Cancel or delete a job"
method: DELETE
path: "/v1/documents/jobs/{id}"
tags: ["Documents"]
---

# Cancel or delete a job

`DELETE /v1/documents/jobs/{id}`

## Request

- Base URL: `https://console.nace.ai`
- URL: `https://console.nace.ai/v1/documents/jobs/{id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/nace/apis/drex-api/docs/v1/documents/jobs/:id/delete.ts> (a function with typed inputs; its response is checked against the schema)

Cancels the job if it is still running, removes it from the list and queues content erasure. Its record stays readable by id for status and billing. A job cancelled before completion is not charged, including delivered parts; a finished one keeps its charge. Also cancels a recorded workspace processing job started directly by your account. Workspace and file deletion jobs and automatically chained child jobs cannot be cancelled through this route. Shared read access does not grant cancellation rights; another account's job returns `404`. Your account keeps control of its own recorded processing jobs after sharing ends or the workspace is deleted. For a submission rejected before NDI created a job, use the local ID returned in the x-drex-document-job response header to delete its retained request and error.

## Path parameters

- `id` string, uuid, required

## Response `204`

Deleted.

## Other responses

- `401`: Missing or invalid API key (`authentication_error`, code `invalid_api_key`).
- `404`: No job with this id for this account (`not_found_error`).
- `409`: The document service refused the delete (`conflict_error`).
- `429`: Over the account's requests per minute for document routes, or the document service is throttling this account (`rate_limit_error`).
- `500`: Something failed on Drex's side (`internal_error`).
- `502`: The document service refused Drex's own request (`upstream_error`, code `ndi_refused_drex`). Retry later.
- `503`: The document service is unavailable (`service_unavailable`).
- `504`: The document service timed out (`upstream_error`).
- `529`: The public API is paused (code `service_disabled`) (`overloaded`).

---

[API](https://skmtc.dev/nace/apis/drex-api.md) - [All operations](https://skmtc.dev/nace/apis/drex-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nace/apis/drex-api/revisions/a0e62d925a61?raw)