---
title: "List retained generations of a Drive file (API)"
method: GET
path: "/v3/drive/files/versions"
tags: ["v3", "Drive"]
---

# List retained generations of a Drive file (API)

`GET /v3/drive/files/versions`

List retained generations for a Drive file path. Authenticate with your API
    key in the Authorization header: `Authorization: Bearer <your-api-key>`.

## Query parameters

- `path` string, required

## Response `200`

Retained generations for the path

- DriveVersionListResponse — Response listing retained generations for a Drive file path.
  - `path` string, required — Drive-relative path that was queried
  - `versions` DriveFileVersion[], required — Versions sorted newest first
    - `generation` integer, required — GCS generation ID
    - `updated` string, date-time, required — When this generation was written
    - `size_bytes` integer, required — Size of this generation in bytes
    - `is_current` boolean, required — True if this is the live generation

## Other responses

- `400` — Invalid path
- `403` — Invalid or missing API key
- `404` — File not found
- `422` — Validation Error
- `500` — Failed to list versions

---

[API](https://skmtc.dev/definite/apis/defapi.md) · [All operations](https://skmtc.dev/definite/apis/defapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/definite/defapi/revisions/3943d8deb3be/schema)