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
{
"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.