---
title: "Get Gemini file"
method: GET
path: "/v1beta/files/{fileId}"
tags: ["Gemini Resources"]
---

# Get Gemini file

`GET /v1beta/files/{fileId}`

## Request

- Base URL: `https://api.tokenlab.sh`
- URL: `https://api.tokenlab.sh/v1beta/files/{fileId}`
- Auth: one of:
  - HTTP bearer
  - API key in header `x-goog-api-key`

Reads metadata for a Gemini file. Resources can only be read, referenced, changed, or deleted in their owning Workspace. Missing, expired, or inaccessible resources return a Gemini-format error.

## Path parameters

- `fileId` string, required

## Query parameters

- `key` string

## Response `200`

Success

- GeminiFileResource: A Gemini file in the current Workspace. Fields are returned when available.
  - `name` string: File resource name such as files/{fileId}.
  - `displayName` string: Human-readable file name.
  - `mimeType` string: Media MIME type.
  - `sizeBytes` string: File byte size as a decimal string.
  - `uri` string: File URI to use in Gemini content parts.
  - `state` string: Processing state reported by the service. Wait until the file is ready before generation.
  - `createTime` string, date-time
  - `updateTime` string, date-time
  - `expirationTime` string, date-time
  - `error` object

## Other responses

- `400`: Gemini-format resource error
- `401`: Gemini-format resource error
- `403`: Gemini-format resource error
- `404`: Gemini-format resource error
- `409`: Gemini-format resource error
- `429`: Gemini-format resource error
- `502`: Gemini-format resource error
- `503`: Gemini-format resource error

---

[API](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway.md) · [All operations](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/tokenlab/apis/tokenlab-ai-gateway/revisions/3208bfbcda22?raw)