Get a file record with download URLs

GET

/spaces/:spaceId/files/:fileId

GET

/spaces/:spaceId/files/:fileId

$ curl https://api.cloudraker.com/spaces/spaceId/files/fileId \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json"

200Retrieved

1 {
2   "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
3   "fileName": "invoice_2024_01.pdf",
4   "parentType": "space",
5   "parentId": "space_987654321",
6   "mimeType": "application/pdf",
7   "size": 254312,
8   "status": "processing",
9   "processingKind": "doc-simple",
10   "createdAt": "2024-01-15T09:30:00Z",
11   "processingError": "",
12   "artifacts": [
13     "structured",
14     "transcript"
15   ],
16   "indexVectors": true,
17   "indexOntology": true,
18   "storedAt": "2024-01-15T09:45:00Z",
19   "processedAt": "",
20   "urls": {
21     "file": "https://cdn.cloudraker.com/spaces/space_987654321/files/f47ac10b-58cc-4372-a567-0e02b2c3d479/original.pdf?token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9",
22     "processedJson": "",
23     "processedMd": "",
24     "previewPdf": ""
25   }
26 }

Returns the file record plus a urls object of minted download links, each valid ~1 hour: urls.file (the stored original), and once processing has produced them, urls.processedMd (extracted markdown) and urls.processedJson (structured/grounded JSON). The record also carries status (waiting | stored | processing | processed | failed), processingKind, processingError, size, artifacts, and createdAt/storedAt/processedAt timestamps — poll this endpoint after uploading to watch status. Returns 404 if the file does not belong to :spaceId (cross-space access is hidden). Authorization: requires space:read on :spaceId (missing permission → 404; org admins bypass).

Returns the file record plus a `urls` object of minted download links, each valid ~1 hour: `urls.file` (the stored original), and once processing has produced them, `urls.processedMd` (extracted markdown) and `urls.processedJson` (structured/grounded JSON). The record also carries `status` (waiting | stored | processing | processed | failed), `processingKind`, `processingError`, `size`, `artifacts`, and createdAt/storedAt/processedAt timestamps — poll this endpoint after uploading to watch `status`. Returns 404 if the file does not belong to :spaceId (cross-space access is hidden). Authorization: requires `space:read` on :spaceId (missing permission → 404; 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 record, with minted ~1h download URLs.

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.