files

Retrieve file

Returns metadata about a specific file, including its size, creation time, and purpose.

get/files/{file_id}

Path parameters

file_idstring required

The file ID returned when the file was uploaded.

Response

File metadata.

bytesinteger required

context_namestring nullable

Context name: "Personal" for individual files, or the organization name

context_typestring nullable

Context type: "personal" or "organization"

created_atinteger required

created_by_emailstring nullable

Email of the individual who created this file (resolved from api_key attribution)

expires_atinteger nullable

filenamestring required

idstring required

object'file' required

Object type - always "file"

purpose'batch' | 'batch_output' | 'batch_error' required

Purpose for file

sourcestring nullable

Source: "sync" if ingested from an external connection, absent for uploaded files

source_namestring nullable

Name of the source connection (e.g. "prod-s3-inputs")

Example response

{
  "bytes": 12045,
  "created_at": 1703187200,
  "filename": "batch_requests.jsonl",
  "id": "file-abc123",
  "object": "file",
  "purpose": "batch"
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.