Get files 1

GET /files/{file_id}

Error

A valid request URL is required to generate request examples

200

{
  "id": "<string>",
  "bytes": 123,
  "created_at": 123,
  "filename": "<string>",
  "object": "file",
  "purpose": "assistants",
  "status": "uploaded",
  "expires_at": 123,
  "status_details": "<string>"
}

Authorizations

ApiKeyAuthApiKeyAuth_OAuth2Auth

api-key · string · header · required

Path Parameters

file_id · string · required

The ID of the file to use for this request.

Query Parameters

api-version · enum<string> · default: v1

The explicit Azure AI Foundry Models API version to use for this request. v1 if not otherwise specified.

Available options: v1, preview

Response

200

application/json

The request has succeeded.

id · string · required

The file identifier, which can be referenced in the API endpoints.

bytes · integer<int64> | null · required

The size of the file, in bytes.

created_at · integer<unixtime> · required

The Unix timestamp (in seconds) for when the file was created.

filename · string · required

The name of the file.

object · enum<string> · required

The object type, which is always file.

Available options: file

purpose · enum<string> · required

The intended purpose of the file. Supported values are assistants, assistants_output, batch, batch_output, fine-tune and fine-tune-results.

Available options: assistants, assistants_output, batch, batch_output, fine-tune, fine-tune-results, evals

status · enum<string> · required

Available options: uploaded, pending, running, processed, error, deleting, deleted

expires_at · integer<unixtime>

The Unix timestamp (in seconds) for when the file will expire.

status_details · string · deprecated

Deprecated. For details on why a fine-tuning training file failed validation, see the error field on fine_tuning.job.