Files

Retrieve file metadata

Changed on

Retrieve the metadata for a single uploaded data file.

get/v1/files/{id}

Request

  • Base URL
    https://api.together.ai
  • URL
    https://api.together.ai/v1/files/{id}
  • Auth
    HTTP bearer

Path parameters

idstring required

The ID of the file to retrieve

Response

File retrieved successfully

idstring required

ID of the file.

object'file' required

The object type, which is always file.

created_atinteger required

The timestamp when the file was created.

filenamestring required

The name of the file as it was uploaded.

bytesinteger required

The number of bytes in the file.

purpose'fine-tune' | 'calibration' | 'eval' | 'batch-api' required

The purpose of the file

FileType'csv' | 'jsonl' | 'parquet' required

The type of the file

processing_status'PENDING' | 'QUEUED' | 'RUNNING' | 'COMPLETED' | 'FAILED' | 'INVALID_FORMAT'

Lifecycle state of a file in the validation pipeline. The typical progression is PENDING → QUEUED → RUNNING → COMPLETED / FAILED. INVALID_FORMAT is a terminal state for files whose contents failed validation in a user-correctable way.

Example response

{
  "filename": "my_file.jsonl",
  "purpose": "fine-tune",
  "FileType": "jsonl"
}

Changes