Retrieve file metadata

# Docs for v1 can be found by changing the above selector ^ from together import Together import os client = Together( api_key=os.environ.get("TOGETHER_API_KEY"), ) file = client.files.retrieve(id="file-id") print(file)

{ "id": "<string>", "object": "<unknown>", "created_at": 123, "filename": "my_file.jsonl", "bytes": 123, "purpose": "fine-tune", "Processed": true, "FileType": "jsonl", "validation_report": { "valid": true, "dataset_format": "<string>", "dataset_has_sample_weights": true, "dataset_has_message_weights": true, "dataset_is_multimodal": true, "dataset_has_tools": true, "dataset_has_parallel_tool_calls": true, "dataset_has_reasoning": true, "nlines": 123, "file_id": "<string>", "error_type": "INVALID_FORMAT", "error": "<string>" } }

Authorizations

Authorization

string

header

default:default

required

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

Path Parameters

string

required

The ID of the file to retrieve

Response

200 - application/json

File retrieved successfully

Structured information describing a file uploaded to Together.

string

required

ID of the file.

object

any

required

The object type, which is always file.

created_at

integer

required

The timestamp when the file was created.

filename

string

required

The name of the file as it was uploaded.

Example:

"my_file.jsonl"

bytes

integer

required

The number of bytes in the file.

purpose

enum<string>

required

The purpose of the file as it was uploaded.

Available options:

fine-tune,

eval,

batch-api

Example:

"fine-tune"

Processed

boolean

required

deprecated

Deprecated. Whether file has been fully uploaded.

FileType

enum<string>

default:jsonl

required

The type of the file such as jsonl, csv, or parquet.

Available options:

csv,

jsonl,

parquet

Example:

"jsonl"

processing_status

enum<string>

Lifecycle state of the file validation pipeline. Files for non-fine-tune purposes skip validation.

Available options:

PENDING,

QUEUED,

RUNNING,

COMPLETED,

FAILED,

INVALID_FORMAT

validation_report

object

Report produced by the file validation pipeline. Present once validation has run; absent on files that bypassed validation (non-fine-tune purposes) or have not yet been validated.

Show child attributes

TOGETHER APIS

SDK LIBRARIES

ERROR CODES

Authorizations

Path Parameters

Response