---
title: "Upgrade the sandbox-api"
method: POST
path: "/upgrade"
tags: ["system"]
---

# Upgrade the sandbox-api

`POST /upgrade`

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)

## Request body

- UpgradeRequest
  - `baseUrl` string — Base URL for releases (useful for forks)
  - `version` string — Version to upgrade to: "latest" (default), "develop", "main", or specific tag like "v1.0.0"

## Response `200`

Upgrade initiated

- SuccessResponse
  - `message` string, required
  - `path` string

## Other responses

- `500` — Internal server error

---

[API](https://skmtc.net/blaxel/apis/blaxel-control-plane.md) · [All operations](https://skmtc.net/blaxel/apis/blaxel-control-plane/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blaxel/blaxel-control-plane/revisions/dfa264bc72ee/schema)