---
title: "List drives"
method: GET
path: "/v2/sandboxes/drives"
tags: ["sandboxes"]
---

# List drives

`GET /v2/sandboxes/drives`

Retrieves a paginated list of drives belonging to a specific project. Drives are in private beta. Register your interest to get access: https://vercel.com/changelog/drives-for-vercel-sandbox-in-private-beta

## Query parameters

- `projectId` string — The project ID or name associated with the drives. Required unless using a Vercel OIDC token scoped to a project.
- `limit` number — Maximum number of drives to return in the response. Used for pagination.
- `cursor` string — Opaque pagination cursor from a previous response.
- `sortBy` 'createdAt' | 'updatedAt' | 'name' — Field to sort drives by.
- `namePrefix` string — Filter drives whose name starts with this prefix. Only valid when sortBy=name.
- `sortOrder` 'asc' | 'desc' — Sort direction for results.
- `teamId` string
- `slug` string

## Response `200`

- object
  - `drives` Drive[], required
    - `name` string, required — The unique drive name within the project.
    - `projectId` string, required — The project that owns the drive.
    - `maxSizeBytes` number, required — The maximum drive size in bytes.
    - `currentSessionId` string — Current session ID the drive is attached to, if any.
    - `currentSandboxName` string — Current sandbox name the drive is attached to, if any.
    - `createdAt` number, required — The time when the drive was created, in milliseconds since the epoch.
    - `updatedAt` number, required — The last time the drive was updated, in milliseconds since the epoch.
  - `pagination` object, required
    - `count` number, required
    - `next` string, nullable, required

## Other responses

- `400` — One of the provided values in the request query is invalid.
- `401` — The request is not authorized.
- `403` — You do not have permission to access this resource.
- `404`
- `410`
- `429`

---

[API](https://skmtc.net/vercel/apis/api.md) · [All operations](https://skmtc.net/vercel/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vercel/api/versions/61d1ba3f6dac/schema)