---
title: "POST /sandbox/live/{chat_id}"
method: POST
path: "/sandbox/live/{chat_id}"
tags: ["sandbox"]
---

# POST /sandbox/live/{chat_id}

`POST /sandbox/live/{chat_id}`

## Path parameters

- `chat_id` string, uuid, required

## Request body

- GetSandboxRequest
  - `modal_control_service_url_override` string, nullable — Override URL for the modal control service (for testing/development)

## Response `200`

Live sandbox retrieved or created 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` — Chat session 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/live/:chat_id/post.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)