---
title: "List retained generations of a Drive file"
method: GET
path: "/v3/teams/{team_id}/drive/files/versions"
tags: ["v3", "Drive"]
---

# List retained generations of a Drive file

`GET /v3/teams/{team_id}/drive/files/versions`

List all retained GCS generations for a single Drive file path.

    Versions are returned newest first. Use the `generation` from a non-current
    entry as the input to `POST /v3/teams/{team_id}/drive/files/restore` to roll
    the live file back to that point in time.

    Versioning is a property of the underlying GCS bucket; this endpoint exposes
    those generations without any caching layer.

## Path parameters

- `team_id` string, required

## 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` — Cannot access files outside your team
- `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/5ea378187147/schema)