Skip to content
docstack-ocr

Retry Document Job Endpoint

POST
/v1/documents/{job_id}/retry
 
curl --request POST \
  --url http://localhost:8080/v1/documents/example/retry

Re-enqueue a failed or rejected job with the same input.

Status guard relaxed from {failed} to {failed, rejected} — catastrophic schema violations look the same as a transient failure to a “same input, same settings” operator. Use /reprocess to swap templates or to re-run a completed / needs_review job. The body of the mutation lives in api.services.jobs.retry_document_job so this route is a pure permission + error-mapping shim.

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
job_id
required
Job Id
string

Responses

Section titled “ Responses ”

202

Section titled “202 ”

Successful Response

Media type application/json
JobActionResponse
object
job_id
required
Job Id
string
status
required
Status
string
Allowed values: queued processing completed needs_review rejected failed
failure_code
Any of:
string
failure_message
Any of:
string
Example 
{
  "status": "queued"
}

422

Section titled “422 ”

Validation Error

Media type application/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object
Example generated
{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example",
      "input": "example",
      "ctx": {}
    }
  ]
}