ConverterHQDevelopers
Documentation

Jobs and Tasks

Build conversion DAGs with parallel branches, retries and durable attempts.

A Job is a directed acyclic graph of named Tasks. Independent branches run in parallel and downstream Tasks become ready only after their dependencies complete.

Execution model

Import Tasks produce Files, convert Tasks transform them, and export Tasks deliver results. Every physical execution is preserved as a TaskAttempt for diagnostics.

Example Job

Job request
{
  "tag": "quickstart-docx-pdf",
  "client_reference_id": "example-quickstart-001",
  "retention_seconds": 3600,
  "tasks": {
    "convert": {
      "operation": "convert",
      "input": {
        "file_id": "file_example_input"
      },
      "options": {
        "input_format": "docx",
        "output_format": "pdf",
        "settings": {}
      }
    }
  }
}

Retries and failures

Infrastructure retries, engine fallback and user-initiated retries are separate concepts. Deterministic invalid inputs are not blindly retried. A retry creates a new attempt instead of erasing history.

Cancellation

Cancellation prevents downstream scheduling, invalidates queued work and signals running workers to terminate converter process groups and clean temporary files.