v1

latestOpenAPI 3.0.32026-07-22194221292.5 KB

system

Upgrade the sandbox-api

Triggers an upgrade of the sandbox-api process. Returns 200 immediately before upgrading. The upgrade will: download the specified binary from GitHub releases, validate it, and restart. All running processes will be preserved across the upgrade. Available versions: "latest" (default, most recent release), "develop", "main", or specific tag like "v1.0.0" You can also specify a custom baseUrl for forks (defaults to https://github.com/blaxel-ai/sandbox/releases)

post/upgrade

Request body

baseUrlstring

Base URL for releases (useful for forks)

versionstring

Version to upgrade to: "latest" (default), "develop", "main", or specific tag like "v1.0.0"

Example request

{
  "baseUrl": "https://github.com/blaxel-ai/sandbox/releases",
  "version": "latest"
}

Response

Upgrade initiated

messagestring required

pathstring

Example response

{
  "message": "File created successfully",
  "path": "/path/to/file"
}