Overview

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

The microsandbox cloud REST API manages sandboxes, volumes, quotas, usage, and audit events for your organization. It is the control-plane API behind the SDKs and CLI. Reach for it directly from environments without an SDK, or for automation around usage and auditing. 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.

Base URL

https://api.microsandbox.dev

Authentication

Authenticate every request with an organization API key (msb_...) as a bearer token. Keys are created in the dashboard. The key identifies your organization; no org identifier appears in these paths.

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

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

Sandboxes

Volumes

Quotas

Usage

Audit events

Organization

Members

Base URL

Authentication

Errors

Usage and billing

​Base URL

​Authentication

​Errors

​Pagination

​Usage and billing

Base URL

Authentication

Errors

Pagination

Usage and billing