Get a file

GET

https://api.cloudraker.com/v1/spaces/:spaceId/files/:id

Returns a file’s metadata and where it is in the pipeline.

{id} accepts the file id or the file name. A name has to match exactly one file here, otherwise the call answers 409 ambiguous_file_name.

status walks uploading → processing → ready, or lands on failed with an error. Poll this route after registering a file until it reads ready.

Once ready, urls carries signed links valid for about an hour:

content — the original bytes.
markdown and json — the parsed forms, present when the file was parsed.

Learn more: Working with files

Authentication

AuthorizationBearer

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

Path parameters

idstringRequired>=1 character

spaceIdstringRequired

Response

The file.

object"file"

idstring

namestring

mimeTypestring

statusenum

Allowed values:

createdAtstring

parentFileIdstringOptional

metadatamap from strings to stringsOptional

errorstringOptional

uploadUrlstringOptional

uploadExpiresAtstringOptional

urlsobjectOptional

Errors

404

Not Found Error

409

Conflict Error

429

Too Many Requests Error