Get Reprocess
Single reprocess envelope. Use to poll a long-running orchestration
โ status walks pending โ processing โ completed | failed. The
wire URL retains /tasks/:taskId and the JSON type is still
dds_record_task.
โถPath params
| Param | Description |
|---|---|
recordId | DDS record id |
taskId | Reprocess id (the dds_record_task id returned by Create Reprocess) |
โถResponse
| Field | Notes |
|---|---|
attributes.operation | "create_version" | "generate_audit_trail_pdf" โ this route resolves any dds_record_task by id |
attributes.status | pending | processing | completed | failed |
attributes.end_date | The end_date supplied to Create Reprocess, or null |
attributes.include_unaccounted_plots | The flag supplied to Create Reprocess |
attributes.created_at / updated_at | ISO 8601. updated_at advances as the worker progresses. |
attributes.error_message | Non-null only when status = "failed" |
attributes.result | Non-null only when status = "completed". Carries the new version_id and version_number so callers can navigate straight to the freshly cut version. |
โถErrors
| Status | Code | When |
|---|---|---|
| 401 | UNAUTHORIZED | Missing/invalid API key |
| 404 | NOT_FOUND | Record or reprocess isn't visible (or the reprocess doesn't belong to this record) |
Required scope:
ingestions:read