Retry processing for a failed file

POST

/spaces/:spaceId/files/:fileId/reprocess

POST

/spaces/:spaceId/files/:fileId/reprocess

$ curl -X POST https://api.cloudraker.com/spaces/spaceId/files/fileId/reprocess \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{}'

1 {
2   "id": "a1b2c3d4",
3   "fileName": "invoice_2024-01.pdf",
4   "parentType": "space",
5   "parentId": "space_987654321",
6   "mimeType": "application/pdf",
7   "size": 245678.5,
8   "status": "waiting",
9   "processingKind": "doc-simple",
10   "createdAt": "2024-01-15T09:30:00Z",
11   "processingError": "",
12   "artifacts": [
13     "structured"
14   ],
15   "indexVectors": true,
16   "indexOntology": true,
17   "storedAt": "2024-01-15T09:35:00Z",
18   "processedAt": "2024-01-15T09:40:00Z",
19   "urls": {
20     "file": "https://cdn.cloudraker.com/spaces/space_987654321/files/a1b2c3d4/original.pdf?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9",
21     "processedJson": "https://cdn.cloudraker.com/spaces/space_987654321/files/a1b2c3d4/processed.json?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9",
22     "processedMd": "https://cdn.cloudraker.com/spaces/space_987654321/files/a1b2c3d4/processed.md?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9",
23     "previewPdf": "https://cdn.cloudraker.com/spaces/space_987654321/files/a1b2c3d4/preview.pdf?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9"
24   }
25 }

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).

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.

processingKindenum or null

createdAtdatetime

processingErrorstring

artifactslist of strings

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

indexVectorsboolean

indexOntologyboolean

storedAtdatetime

processedAtdatetime

urlsobject

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

Errors

409

Conflict Error