4e064cf81dae

latestOpenAPI 3.1.02026-08-131831,331960.0 KB
openAiBatch

Retrieve a file

Retrieve metadata for a file from the upstream OpenAI Files API.

get/api/files/{file_id}/

Path parameters

file_idstring required

OpenAI file ID.

Query parameters

provider_idstring required

Provider route with customer-owned credentials, for example openai or parasail.

Headers

Authorizationstring required

Use your Respan API key for Respan API authentication. Enter only the Respan API key value; clients send Authorization: Bearer <RESPAN_API_KEY>. For /api/responses, provider credentials such as Perplexity, OpenAI, or Azure OpenAI go in Settings -> Providers or respan_params.credential_override in the request body, not in this authentication field.

Response

File details.

idstring required

File ID.

objectstring required
bytesinteger

File size in bytes.

created_atinteger

Unix timestamp.

filenamestring
purposestring
statusstring

File status.

{"stackTrail":"components:schemas:OpenAI Batch_retrieveFile_Response_200:properties:status_details:oneOf","oasType":"schema","type":"unknown","description":"Any type","nullable":true}