Skip to main content
GET
/
files
/
{file_id}
Python
import os
from datagrid_ai import Datagrid

client = Datagrid(
    api_key=os.environ.get("DATAGRID_API_KEY"),  # This is the default and can be omitted
)
file_object = client.files.retrieve(
    "file_id",
)
print(file_object.id)
{
  "object": "file",
  "id": "<string>",
  "filename": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "media_type": "<string>",
  "expires_at": "2023-11-07T05:31:56Z",
  "credits": {
    "consumed": 123
  }
}

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
file_id
string
required

The id of the file to retrieve.

Response

Retrieved file

The File object represents a document that has been uploaded to Datagrid.

​
object
enum<string>
required

The object type, which is always file.

Available options:
file
​
id
string
required

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

​
filename
string
required

The name of the file

​
created_at
string<date-time>
required

The ISO string for when the file was created.

​
media_type
string
required

The media type of the file.

​
expires_at
string<date-time> | null

The ISO timestamp when the file will expire and be automatically deleted, or null if the file does not expire.

​
credits
object

Credit consumption for this file upload. null when the billing lookup fails.