---
title: "Ingest Cancel"
method: DELETE
path: "/v2/ingest/{job_id}"
tags: ["v2", "v2-ingest"]
---

# Ingest Cancel

`DELETE /v2/ingest/{job_id}`

## Request

- Base URL: `https://api.enconvert.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.enconvert.com/v2/ingest/{job_id}`
- Auth: none declared

Cancel an ingest job (idempotent; terminal jobs return unchanged).

## Path parameters

- `job_id` string, required

## Headers

- `X-API-Key` string, nullable
- `authorization` string, nullable

## Response `200`

Successful Response

- IngestJobResponse: Lifecycle view of one ingest job (POST 202, GET, DELETE all share it).
  - `job_id` string, required
  - `status` 'queued' | 'discovering' | 'processing' | 'completed' | 'failed' | 'canceled', required
  - `mode` 'urls' | 'sitemap' | 'crawl' | 'files', required
  - `pages_discovered` integer
  - `pages_found` integer, nullable: Unique eligible URLs discovery yielded BEFORE the max_pages cap (sitemap: true unique count; crawl: bounded by the crawl budget, so a lower bound). Absent for explicit-urls jobs and jobs created before migration 026.
  - `discovery_truncated` boolean: True when discovery found more unique URLs than max_pages allowed the job to enqueue.
  - `pages_processed` integer
  - `pages_failed` integer
  - `total_chunks` integer
  - `output_url` string, nullable: Signed URL to the final JSONL; present once completed.
  - `error_message` string, nullable
  - `webhook_url` string, nullable: Completion-webhook target registered for this job, if any.
  - `webhook_delivered` boolean: True once the signed completion webhook got a 2xx (H.8).
  - `created_at` string, date-time, nullable
  - `completed_at` string, date-time, nullable
  - `warnings` string[]

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/enconvert/apis/conversion-api.md) · [All operations](https://skmtc.dev/enconvert/apis/conversion-api/llms.txt) · [OpenAPI document](https://skmtc.dev/enconvert/apis/conversion-api/revisions/b8c820393569?raw)