sandboxes

List snapshots

Changed on

Retrieves a paginated list of snapshots for a specific project.

get/v2/sandboxes/snapshots

Request

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

Query parameters

projectstring

The unique identifier or name of the project to list snapshots for.

Example:prj_abc123
namestring

Name for the sandbox. Must be unique per project and URL-safe (alphanumeric, hyphens, underscores).

Example:my-sandbox
limitnumber

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

Example:20
cursorstring

Opaque pagination cursor from a previous response.

sortOrder'asc' | 'desc'

Sort direction for results by creation time.

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

object required
OR

Example response

{
  "snapshots": [
    {
      "createdAt": 1750344501629,
      "creationMethod": "manual",
      "expiresAt": 1750344501629,
      "id": "snap_123a6c5209bc3778245d011443644c8d27dc2c50",
      "lastUsedAt": 1750344501629,
      "parentId": "snap_parent123",
      "region": "iad1",
      "regions": [
        "iad1",
        "sfo1"
      ],
      "sizeBytes": 104857600,
      "sourceSessionId": "sbx_123a6c5209bc3778245d011443644c8d27dc2c50",
      "status": "created",
      "updatedAt": 1750344501629
    }
  ]
}

Changes