APIs
Generators
Stacks
Projects

Docs
History
Schema
Generate

Filter operations

AdminGate2

Agents62

AI Applications30

AI Chat44

AI Gateway14

AI Gateway Admin12

AI Gateway Limits5

AI Gateway Pricing1

AI Gateway Usage8

AI Provider Status3

Alarms14

Alerts6

Analytics43

Analytics Ingest Keys6

API Keys9

Audit Logs2

Authentication29

Autofixer7

Backups36

Blob6

Blob Management6

CI builder3

CI runner6

Cloud8

Compose3

Containers8

Crons3

Custom Domains8

Dashboards5

Deployment Tokens6

Deployments25

DNS1

DNS Providers14

DNS Records4

Domains19

Email Domains12

Email Providers9

Email Tracking7

Email Validation1

Emails5

Environments2

error-alert-rules5

error-tracking10

Events13

External Images7

External Services50

External Services - Query11

Feature Flags9

Files1

Funnels7

GenAI2

geo2

Git Provider Connections3

Git Providers35

HTTP Checks12

Imports5

Insights1

Internal DNS2

IP Access Control6

KV Management6

KV Store7

Load Balancer5

Logs11

Metrics17

Nodes28

Notification Preferences4

Notification Providers15

Notification Routes7

Observability2

Operations1

OTel15

OTel Facets4

OTel Ingest6

Performance6

Platform6

Postgres Upgrades7

Presets2

Preview Gateway6

Project Groups22

Project IP Access8

Projects47

Proxy Logs14

Public Repositories6

Repositories6

Restore6

Revenue16

Runtime health3

Sandboxes40

get/v1/sandboxes
post/v1/sandboxes
get/v1/sandboxes/placementList the nodes sandboxes can be placed on and the operator allow-list.
put/v1/sandboxes/placementSet which nodes may run new sandboxes. Admin only.
get/v1/sandboxes/placement/nodes/{node}List every live sandbox on one node, from all owners. Admin only: it exposes other users' sandboxes.
post/v1/sandboxes/placement/nodes/{node}/evictDestroy every live sandbox on a worker node, from all owners, so the node can be removed. Works on a node that is offline for good: its sandboxes are marked destroyed even when the node cannot be reached. Admin only.
get/v1/sandboxes/rootfsInspect rootfs storage: the Firecracker digest-keyed cache (with which sandboxes reference each entry) and per-VM disks. Empty on Docker-only hosts. Admin/read scope — this exposes host storage layout.
post/v1/sandboxes/rootfs/gcReclaim rootfs cache entries not backing any live sandbox. Idempotent; safe to call any time (live VMs hold their own per-VM disks).
get/v1/sandboxes/{id}
post/v1/sandboxes/{id}/cmdRun a command inside the sandbox (`@vercel/sandbox`-compatible).
get/v1/sandboxes/{id}/cmd/{cmd_id}
get/v1/sandboxes/{id}/cmd/{cmd_id}/logsStream a command's stdout/stderr as `application/x-ndjson` (`@vercel/sandbox`-compatible). Each line is either `{stream:"stdout"|"stderr", data:"..."}` or `{stream:"error", data:{code, message}}`.
post/v1/sandboxes/{id}/destroy
get/v1/sandboxes/{id}/domain
get/v1/sandboxes/{id}/eventsThe operations timeline for a sandbox (lifecycle events only — never shell/exec activity), newest first.
post/v1/sandboxes/{id}/exec
post/v1/sandboxes/{id}/exec-detached
post/v1/sandboxes/{id}/extend-timeout
get/v1/sandboxes/{id}/fs/list
post/v1/sandboxes/{id}/fs/mkdir
get/v1/sandboxes/{id}/fs/read
get/v1/sandboxes/{id}/fs/stat
post/v1/sandboxes/{id}/fs/writeWrite a file into the sandbox. Accepts two body shapes — the SDK picks one based on `Content-Type`:
post/v1/sandboxes/{id}/fs/write-batchBatch-write multiple files in a single request. Mirrors `@vercel/sandbox` `writeFiles()`. Semantics are fail-fast: if any file errors, previously-written entries are left in place and the error describes which file broke.
get/v1/sandboxes/{id}/jobs
get/v1/sandboxes/{id}/jobs/{job_id}
post/v1/sandboxes/{id}/jobs/{job_id}/killTerminate a detached job. Aborts the server-side tracking task and sends SIGTERM (or SIGKILL if `force=true`) to any matching processes inside the sandbox container. Returns 204 on success; 404 if the sandbox or job is unknown.
get/v1/sandboxes/{id}/jobs/{job_id}/logsSSE endpoint streaming each stdout/stderr line from a detached job as it's produced. Mirrors the `Command.logs()` async iterator shape on `@vercel/sandbox` — events carry `{ stream, data }`.
post/v1/sandboxes/{id}/pause
post/v1/sandboxes/{id}/preview-linkMint a shareable link to a sandbox preview.
put/v1/sandboxes/{id}/preview-password
delete/v1/sandboxes/{id}/preview-password
post/v1/sandboxes/{id}/resizeGrow a Firecracker sandbox's root disk. Offline resize — the VM reboots (filesystem/data persist) rather than resizing fully live.
post/v1/sandboxes/{id}/restart
post/v1/sandboxes/{id}/resume
post/v1/sandboxes/{id}/runtime-environmentIssue the same scoped service variables used by a deployment runtime for the project attached to this sandbox.
post/v1/sandboxes/{id}/source
post/v1/sandboxes/{id}/stop
get/v1/sandboxes/{id}/terminalAttach an interactive terminal to a sandbox.
post/v1/sandboxes/{id}/{cmd_id}/killKill a running command (`@vercel/sandbox`-compatible). The SDK calls `POST /v1/sandboxes/{id}/{cmdId}/kill` — note the path has the command ID directly under the sandbox, NOT under `/jobs/` or `/cmd/`.

Secrets7

sentry-compat6

sentry-ingestor3

Settings16

Snapshots5

source-maps8

Static Bundles4

Status Page32

Teams13

Telemetry2

Telemetry Logs1

Telemetry Metrics4

Templates7

Traces8

Traefik Discovery6

Traffic Delivery11

Users13

Visitor Activity5

Vulnerability Scans8

Webhook Deliveries3

Webhooks6

Workflows1

get/projects/{project_id}/dsnsList all DSNs for a project
post/projects/{project_id}/dsnsCreate a new DSN for a project
post/projects/{project_id}/dsns/get-or-createGet or create DSN for a project/environment/deployment combination
post/projects/{project_id}/dsns/{dsn_id}/regenerateRegenerate DSN keys (rotate keys)
post/projects/{project_id}/dsns/{dsn_id}/revokeRevoke (deactivate) a DSN

Sandboxes

Changes to GET /v1/sandboxes/:id/fs/list

get/v1/sandboxes/{id}/fs/list

Oct 14, 20265cf062ead579 Revision changes
- info
  endpoint added