Retry failed render job
POST/office/render-jobs/{id}/retry
Re-queues a failed render job for reprocessing. Use when a render failed due to a transient worker error or temporary unavailability of an external dependency. The previous failure reason is preserved in the job's attempt log.
Request
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
id | integer | Yes | The numeric ID of the failed render job to retry. |
Responses
202 Job re-queued for reprocessing
Content type application/json, object · OfficeRenderJobV1.
| Field | Type | Required | Description |
|---|---|---|---|
id | integer | No | Auto-incremented primary key. |
template_id | integer | No | ID of the template used for this render job. |
status | string | No | Current lifecycle status of the render job. One of: |
output_formats | array of string | No | List of output formats requested for this job. |
reference_id | string, nullable | No | Optional external reference identifier (e.g. "invoice:42") for linking the job to a source record. |
reference_type | string, nullable | No | The type of the referenced record (e.g. "invoice", "contract"). |
artifacts | array of object, nullable | No | Output artifacts produced by a completed job. Null while still queued or processing. |
artifacts[].format | string | No | The output format of this artifact. |
artifacts[].document_id | integer | No | ID of the document artifact (use for /documents/{id}/download). |
artifacts[].size_bytes | integer | No | File size of the artifact in bytes. |
error_message | string, nullable | No | Human-readable error reason when status is "failed". |
queued_at | string (date-time) | No | |
completed_at | string (date-time), nullable | No |
404 Render job not found
409 Job is not in "failed" status and cannot be retried
Example request
curl -X POST "https://{tenant}.faciotech.net/api/v1/office/render-jobs/{id}/retry" \
-H "Accept: application/json"