---
title: "The sandbox, described"
method: GET
path: "/sandbox"
tags: ["Discovery"]
---

# The sandbox, described

`GET /sandbox`

## Request

- Base URL: `https://youspot.com`
- URL: `https://youspot.com/sandbox`
- Auth: none required

What the sandbox mount is: the base URL, every path mounted under it and what each becomes there, the paths that are deliberately absent, and whether the demo account behind /sandbox/mcp is seeded on this deployment. Read `status` before sending a tools/call there.

## Headers

- `If-None-Match` string

## Response `200`

The sandbox.

- SandboxDescriptor
  - `object` 'sandbox', required
  - `name` string
  - `status` 'available' | 'not_seeded', required: `not_seeded` means tools/list answers and tools/call is a 503 until a demo account exists here.
  - `status_note` string
  - `base_url` string, uri, required
  - `production_base_url` string, uri
  - `mcp_url` string, uri
  - `openapi` string, uri
  - `documentation_url` string, uri
  - `description` string
  - `authentication` object
    - `required` boolean
    - `note` string
  - `mounted` object[], required
    - `path` string, required
    - `production` string, required: The production path this one answers as.
    - `note` string
  - `not_mounted` object[]
    - `path` string
    - `note` string
  - `rate_limit` object
  - `examples` object[]
    - `title` string
    - `request` string
    - `response` string
  - `differences_from_production` string[]

## Other responses

- `304`: The document has not changed since the ETag you sent. No body.

---

[API](https://skmtc.dev/youspot/apis/youspot-http-api.md) · [All operations](https://skmtc.dev/youspot/apis/youspot-http-api/llms.txt) · [OpenAPI document](https://skmtc.dev/youspot/apis/youspot-http-api/revisions/6615ad5d017d?raw)