Read the status of an upload

GET 
/api/v2/files/uploads/:request_id

Status of an upload from POST /api/v2/files or POST /api/v1/upload. Poll until status is done, failed or cancelled; each stored file then has its file_id.

Request

Responses

200

Current upload status

401

Missing or invalid API key

Response Headers

X-Contract-Version

Version of the gaius-api-contracts release the backend runs (legalgpt-contracts), sent on every response. Clients compare it with the @legalgpt/contracts version they were built with; both packages share one version per contract.

Cache-Control

Prevents storage of sensitive authenticated chat data.

Content-Language

Language selected for outgoing generic tool-status labels and known HTTP/timeline error text. HTTP reason-phrase titles remain language-neutral.

404

Resource does not exist or is not visible to the caller

Response Headers

X-Contract-Version

Version of the gaius-api-contracts release the backend runs (legalgpt-contracts), sent on every response. Clients compare it with the @legalgpt/contracts version they were built with; both packages share one version per contract.

Cache-Control

Prevents storage of sensitive authenticated chat data.

Content-Language

Language selected for outgoing generic tool-status labels and known HTTP/timeline error text. HTTP reason-phrase titles remain language-neutral.