Skip to navigation
Paperwork APISpace Files

Retry processing for a failed file

View as Markdown

Resets a failed file to waiting and re-enqueues it for processing (a fresh attempt gets the full automatic retry budget). Returns the updated file record. 409 if the file is not in the failed state; 404 if the file does not belong to :spaceId (cross-space access is hidden). Authorization: requires space:contribute on :spaceId (missing permission → 403; org admins bypass).

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

spaceIdstringRequired
fileIdstringRequired

Response

The file, reset to waiting and re-enqueued.

idstring
fileNamestring
parentTypestring
parentIdstring
mimeTypestring
sizedouble or null
Size in bytes, null until stored.
statusenum

Terminal values are stored (uploaded, no processing requested), processed and failed; waiting and processing mean keep polling.

Allowed values:
processingKindenum or null
Allowed values:
createdAtdatetime
processingErrorstringOptional
parentFileIdstringOptional

Source file this one was generated from (e.g. a redacted or signed copy).

artifactslist of stringsOptional

Parsing byproducts present, e.g. structured, transcript.

indexVectorsbooleanOptional
indexOntologybooleanOptional
storedAtdatetimeOptional
processedAtdatetimeOptional
urlsobjectOptional

Minted download links, each valid ~1 hour. Present on single-file reads only — list responses mint none.

Errors

409
Conflict Error