v14

latestOpenAPI 3.0.32026-08-04377889.4 MB

sandboxes

List sessions

Retrieves a paginated list of sessions belonging to a specific sandbox. Results are sorted by creation time and paginated using an opaque cursor.

get/v2/sandboxes/sessions

Query parameters

projectstring

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

Example:prj_abc123

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

namestring

Filter sessions by sandbox name. Only sessions belonging to the specified sandbox are returned.

Example:my-sandbox

Filter sessions by sandbox name. Only sessions belonging to the specified sandbox are returned.

limitnumber

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

Example:20

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

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

The list of sessions matching the request filters.

object required

Example response

{
  "sessions": [
    {
      "sourceSandboxName": "my-sandbox",
      "projectId": "prj_123a6c5209bc3778245d011443644c8d27dc2c50",
      "id": "sbx_123a6c5209bc3778245d011443644c8d27dc2c50",
      "memory": 2048,
      "vcpus": 2,
      "region": "iad1",
      "runtime": "node22",
      "timeout": 3600000,
      "status": "running",
      "requestedAt": 1750344501629,
      "startedAt": 1750344501629,
      "cwd": "/vercel/sandbox",
      "requestedStopAt": 1750344501629,
      "stoppedAt": 1750344501629,
      "abortedAt": 1750344501629,
      "duration": 3600000,
      "sourceSnapshotId": "snap_123a6c5209bc3778245d011443644c8d27dc2c50",
      "snapshottedAt": 1750344501629,
      "createdAt": 1750344501629,
      "updatedAt": 1750344501629,
      "networkPolicy": {
        "mode": "custom",
        "allowedDomains": [
          "api.vercel.com",
          "*.example.com"
        ],
        "allowedCIDRs": [
          "10.0.0.0/8"
        ],
        "deniedCIDRs": [
          "10.0.0.0/8"
        ],
        "injectionRules": [
          {
            "domain": "api.vercel.com",
            "headerNames": [
              "Authorization",
              "X-API-Key"
            ]
          }
        ]
      },
      "activeCpuDurationMs": 42,
      "networkTransfer": {
        "in": 12543852,
        "out": 15368
      }
    }
  ]
}