Overview

microsandbox cloud is in private beta; the API is available to organizations with access.

The microsandbox cloud REST API manages sandboxes and the accounts around them. Use it directly when an SDK does not cover your workflow, or when you need account, billing, or audit endpoints. For running code in sandboxes (exec, streaming, PTY, file transfer, SSH), use the SDKs or CLI. They speak the sandbox command channel, which is not part of this REST surface.

Credentials

The sidebar separates endpoints by who the request represents:

Credential	Format	Represents	Use for
API key	`msb_...`	An organization	Services, SDKs, CLI automation, and organization resources
Personal token	`msb_pat_...`	A user	Account and organization administration

API keys and personal tokens are both sent as bearer tokens:

curl https://api.microsandbox.dev/v1/sandboxes \
  -H "Authorization: Bearer $MSB_API_KEY"

API keys are created in the dashboard. API-key paths infer the organization from the key. Personal-token paths include the organization slug when the request needs an organization.

Base URL

https://api.microsandbox.dev

Errors

Errors return an error object with a stable machine-readable code, a human-readable message, and optional structured details:

{
  "error": {
    "code": "invalid_api_key",
    "message": "unauthorized",
    "details": null
  }
}

Pagination

List endpoints use cursor pagination. Pass limit to size the page and cursor to continue from a previous response:

{
  "data": [ ... ],
  "has_more": true,
  "next_cursor": "eyJv..."
}

Request the next page with ?cursor=<next_cursor>; has_more: false means you have everything.

Usage and billing

The usage endpoints report metered consumption for the current period. Reported cost figures are estimates; the dashboard is the source of truth for billing.

Getting Started

API keys

Personal tokens

Credentials

Base URL

Errors

Usage and billing

​Credentials

​Base URL

​Errors

​Pagination

​Usage and billing

Credentials

Base URL

Errors

Pagination

Usage and billing