sandboxes

List drives

Changed on

Retrieves a paginated list of drives belonging to a specific project.

get/v2/sandboxes/drives

Request

  • Base URL: https://api.vercel.com
  • URL: https://api.vercel.com/v2/sandboxes/drives
  • Auth: HTTP bearer

Query parameters

projectIdstring

The project ID or name associated with the drives. Required unless using a Vercel OIDC token scoped to a project.

Example:prj_abc123
limitnumber

Maximum number of drives to return in the response. Used for pagination.

Example:20
cursorstring

Opaque pagination cursor from a previous response.

sortBy'createdAt' | 'updatedAt' | 'name'

Field to sort drives by.

namePrefixstring

Filter drives whose name starts with this prefix. Only valid when sortBy=name.

sortOrder'asc' | 'desc'

Sort direction for results.

teamIdstring
Example:team_1a2b3c4d5e6f7g8h9i0j1k2l

The Team identifier to perform the request on behalf of.

slugstring
Example:my-team-url-slug

The Team slug to perform the request on behalf of.

Response

Example response

{
  "drives": [
    {
      "createdAt": 1750344501629,
      "currentSandboxName": "my-sandbox",
      "currentSessionId": "sbx_123",
      "id": "drive_abc123",
      "maxSizeBytes": 1099511627776,
      "name": "workspace",
      "projectId": "prj_abc123",
      "region": "iad1",
      "updatedAt": 1750344501629
    }
  ]
}

Changes

  • 4a06e85c2848Revision changes
    • info

      added the non-success response with the status

  • b426de1e3932Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status