---
title: "PATCH /sandbox/{sandbox_id}/status"
method: PATCH
path: "/sandbox/{sandbox_id}/status"
tags: ["sandbox"]
---

# PATCH /sandbox/{sandbox_id}/status

`PATCH /sandbox/{sandbox_id}/status`

## Path parameters

- `sandbox_id` string, uuid, required

## Request body

- UpdateSandboxStatusRequest
  - `status` string, required

## Response `200`

Sandbox status updated successfully

- Sandbox
  - `api_url` string, nullable
  - `chat_session_id` string, uuid, required
  - `created_at` string, date-time, required
  - `id` string, uuid, required
  - `latest_node` string, uuid
  - `provider` 'modal' | 'daytona', required
  - `provider_id` string, required
  - `session_id` string, uuid
  - `status` 'alive' | 'terminated', required
  - `tunnel_url` string, required
  - `updated_at` string, date-time, required

## Other responses

- `403` — Forbidden - user not member of project
- `404` — Sandbox not found
- `500` — Internal server error

## Changes

- **2026-01-21** `d4cc893e9116` — 2 breaking, 4 info
  - removed the required property `modal_id` from the response with the `200` status
  - removed the required property `modal_url` from the response with the `200` status
  - added the optional property `api_url` to the response with the `200` status
  - added the required property `provider` to the response with the `200` status
  - …2 more

[Change history](https://skmtc.dev/structifyai/apis/structify/changes/sandbox/:sandbox_id/status/patch.md)

---

[API](https://skmtc.dev/structifyai/apis/structify.md) · [All operations](https://skmtc.dev/structifyai/apis/structify/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/structifyai/structify/revisions/1364930b6980/schema)