Jobs & Batches

Cancel a job

Cancel a pending or processing job. Jobs that are already complete or failed cannot be cancelled and will return a 409 Conflict.

post/v1/jobs/{id}/cancel

Request

  • Base URL: https://api.talonic.com
  • URL: https://api.talonic.com/v1/jobs/{id}/cancel
  • Auth: HTTP bearer

Path parameters

idstring uuid required
Example:a1b2c3d4-e5f6-7890-abcd-ef1234567890

Resource UUID.

Response

Job cancelled.

idstring uuid required
namestring nullable
status'pending' | 'queued' | 'processing' | 'complete' | 'failed' required
progressinteger nullable

Percentage complete (0–100). Only present while processing.

estimated_seconds_remaininginteger nullable
document_countinteger

Total documents in the job.

completed_documentsinteger

Documents that have finished processing.

current_phase'phase_1_resolve' | 'phase_2_strategy' | 'phase_2_execute' | 'phase_2_outliers' | 'phase_3_validation' | 'phase_4_reread' | 'completed' | 'error' nullable

Current pipeline phase.

created_atstring date-time
started_atstring date-time nullable
completed_atstring date-time nullable

Example response

{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "Q1 Invoice Processing",
  "status": "completed",
  "progress": 45,
  "schema": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  },
  "document_count": 150,
  "completed_documents": 67,
  "grid_stats": {
    "total_cells": 8850,
    "filled": 6200,
    "empty": 2650,
    "fill_rate": 0.7
  },
  "error": {
    "message": "Re-extraction started."
  },
  "created_at": "2026-04-25T14:30:00.000Z",
  "started_at": "2026-04-25T14:30:00.000Z",
  "completed_at": "2026-04-25T14:30:00.000Z"
}

Changes

No recorded changes to this operation across all 1 revision of this API.