Cancel Ingest Job

POST /ingest-jobs/{job_id}/cancel

Cancel a queued import. A claimed one is a 409 naming its status.

RULE IJ-1 is that a crashed job is never auto-requeued, because re-embedding duplicates rows. Cancelling a job the worker already claimed is the mirror image of that mistake: the row would say finished while the loop is still committing items into it.

Role floor

Requires member or above. The floor is a minimum, not a grant: scope filtering still applies on top of it, and a resource in another tenant answers 404 rather than 403.

Parameters

Name	In	Type		Notes
job_id	path	string (uuid)	required	—

Responses

Status	Description	Body
200	Successful Response	IngestJobView
422	Validation Error	HTTPValidationError

Only the success paths are declared

Any operation may also answer any status in the error catalogue, and every failure body is the platform envelope — including the 422 this document types as HTTPValidationError.

Example

curl -X POST https://your-deployment.example.com/ingest-jobs/{job_id}/cancel \
  -H "Authorization: Bearer $COBRE_TOKEN"

Response — IngestJobView

Field	Type		Notes
id	string (uuid)	required	—
kb_id	string (uuid)	required	—
status	queued | running | succeeded | failed | cancelled	required	—
stage	analyzing | embedding | null	optional	—
mode	verbatim | analyzed	required	—
source_format	csv | markdown | items | document | url	required	—
source_filename	string | null	optional	—
source_url	string | null	optional	—
total_items	integer	optional	Default 0.
processed_items	integer	optional	Default 0.
created_items	integer	optional	Default 0.
skipped	IngestSkip[]	optional	—
analyzer_run_id	string (uuid) | null	optional	—
tokens_input	integer	optional	Default 0.
tokens_output	integer	optional	Default 0.
cost	string	optional	Default "0".
error_message	string | null	optional	—
started_at	string (date-time) | null	optional	—
finished_at	string (date-time) | null	optional	—
created_at	string (date-time)	required	—