> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coreload.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Destroy a sandbox

> Stops the sandbox's tasks and deletes it and everything in it.

Needs the `use` scope.



## OpenAPI

````yaml /openapi.json delete /v1/sandboxes/{id}
openapi: 3.1.0
info:
  title: Coreload sandbox API
  version: '1'
  description: >-
    Create short-lived sandboxes, run commands in them and move files in and
    out. The API is in beta and not offered to outside callers yet: there are no
    API keys for outside callers. A call gets a ticket for a box from the edge
    with an API key, then calls the box at the ticket's URL with the ticket's
    `authorization` header. Answers are JSON, except a file download (its bytes)
    and a tunnel (a 101 upgrade); a JSON error is `{ok: false, error: {code,
    message}}`.
servers:
  - url: '{box}'
    description: The box URL from your ticket (`url`).
    variables:
      box:
        default: https://box.coreload.example
        description: The ticket's url.
security:
  - ticket: []
  - apiKey: []
tags:
  - name: Access
    description: 'Tickets: how a key reaches a box.'
  - name: Sandboxes
    description: Create, list, get and destroy sandboxes.
  - name: Runs
    description: Run commands in a sandbox and read their results and output.
  - name: Files
    description: Move files in and out of a sandbox.
  - name: Tunnels
    description: >-
      Byte tunnels over an HTTP upgrade: to a sandbox's SSH server or desktop,
      and the relay that answers a sandbox's outbound connections from your
      side.
paths:
  /v1/sandboxes/{id}:
    delete:
      tags:
        - Sandboxes
      summary: Destroy a sandbox
      description: |-
        Stops the sandbox's tasks and deletes it and everything in it.

        Needs the `use` scope.
      operationId: destroySandbox
      parameters:
        - name: id
          in: path
          required: true
          description: The sandbox id (`sbx_` and 12 hex).
          schema:
            type: string
            pattern: ^sbx_[0-9a-f]{12}$
      responses:
        '200':
          description: Destroyed.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Destroyed'
        '401':
          description: Notably `unauthorized`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Notably `scope_missing`, `ip_not_allowed`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Notably `not_found`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '502':
          description: Notably `backend_error`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        default:
          description: >-
            An error: `{ok: false, error: {code, message}}`. This route may
            answer any code in this table (code, then status): `invalid_value`
            400, `unauthorized` 401, `scope_missing` 403, `ip_not_allowed` 403,
            `not_found` 404, `idempotency_conflict` 409, `sandbox_not_ready`
            409, `too_large` 413, `quota_exceeded` 429, `busy` 429,
            `wait_timeout` 504, `backend_error` 502.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Destroyed:
      type: object
      required:
        - sandbox
        - destroyed
      properties:
        sandbox:
          type: string
          description: The sandbox id.
        destroyed:
          const: true
    Error:
      type: object
      required:
        - ok
        - error
      properties:
        ok:
          const: false
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              description: The error code.
              enum:
                - invalid_value
                - unauthorized
                - scope_missing
                - ip_not_allowed
                - not_found
                - backend_error
                - idempotency_conflict
                - sandbox_not_ready
                - too_large
                - quota_exceeded
                - busy
                - wait_timeout
            message:
              type: string
              description: What went wrong, and what to do.
  securitySchemes:
    ticket:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        The ticket's `authorization` value, sent as it is (its own scheme, not
        Bearer), until the ticket's `expiresAt`.
    apiKey:
      type: http
      scheme: bearer
      description: >-
        An API key: `Authorization: Bearer <key>`. The edge takes it for a
        ticket; a box takes a key issued for that box. Keys are not issued to
        outside callers yet.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.