Yandex Cloud
Search
Contact UsTry it for free
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
  • Marketplace
    • Featured
    • Infrastructure & Network
    • Data Platform
    • AI for business
    • Security
    • DevOps tools
    • Serverless
    • Monitoring & Resources
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
    • Price calculator
    • Pricing plans
  • Customer Stories
  • Documentation
  • Blog
© 2026 Direct Cursus Technology L.L.C.
Yandex AI Studio
  • About Yandex AI Studio
  • Getting started with Model Gallery
  • Yandex Workflows
  • Switching from the AI Assistant API to Responses API
  • Compatibility with OpenAI
    • Overview
    • API authentication
        • Overview
        • listFiles
        • createFile
        • deleteFile
        • retrieveFile
        • downloadFile
  • Quotas and limits
  • Pricing policy
  • Access management
  • Audit Trails events
  • Public materials
  • Release notes
  • Terms and definitions

In this article:

  • HTTP request
  • Path parameters
  • Response
  1. API references
  2. OpenAI-compatible APIs
  3. Files
  4. retrieveFile

REST: Retrieve file

Written by
Yandex Cloud
Updated at December 24, 2025
  • HTTP request
  • Path parameters
  • Response

Returns information about a specific file.

HTTP requestHTTP request

GET https://ai.api.cloud.yandex.net/v1/files/{file_id}

Path parametersPath parameters

Field

Description

file_id

string

Required field. The ID of the file to use for this request.

ResponseResponse

HTTP Code: 200

OK

Response schema: application/json

{
  "id": "string",
  "bytes": "integer",
  "created_at": "integer",
  "expires_at": "integer",
  "filename": "string",
  "object": "string",
  "purpose": "string",
  "status": "string",
  "status_details": "string"
}

The File object represents a document that has been uploaded to Yandex Cloud AI Studio.

Field

Description

id

string

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

bytes

integer

Required field. The size of the file, in bytes.

created_at

integer

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

expires_at

integer

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

filename

string

Required field. The name of the file.

object

enum

Required field. The object type, which is always file.

  • file

purpose

enum

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

  • assistants
  • assistants_output
  • batch
  • batch_output
  • fine-tune
  • fine-tune-results
  • vision
  • user_data

status

enum

Required field. Deprecated. The current status of the file, which can be either uploaded, processed, or error.

  • uploaded
  • processed
  • error

status_details

string

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

Was the article helpful?

Previous
deleteFile
Next
downloadFile
© 2026 Direct Cursus Technology L.L.C.