LangSmith sandboxes API

The sandboxes API from LangSmith — 12 operation(s) for sandboxes.

Operations 17

GET /auth/sandbox-access Get sandbox access decision
GET /v2/sandboxes/boxes List sandbox claims
POST /v2/sandboxes/boxes Create a sandbox claim
POST /v2/sandboxes/boxes/batch-delete Batch delete sandbox claims
GET /v2/sandboxes/boxes/{name} Get a sandbox claim
DELETE /v2/sandboxes/boxes/{name} Delete a sandbox claim
PATCH /v2/sandboxes/boxes/{name} Update a sandbox claim
POST /v2/sandboxes/boxes/{name}/service-url Generate a service access token
POST /v2/sandboxes/boxes/{name}/snapshot Capture a snapshot from a sandbox
POST /v2/sandboxes/boxes/{name}/start Start a sandbox
GET /v2/sandboxes/boxes/{name}/status Get sandbox claim status
POST /v2/sandboxes/boxes/{name}/stop Stop a sandbox
GET /v2/sandboxes/snapshots List snapshots
POST /v2/sandboxes/snapshots Create a snapshot
GET /v2/sandboxes/snapshots/{snapshot_id} Get a snapshot
DELETE /v2/sandboxes/snapshots/{snapshot_id} Delete a snapshot
GET /v2/sandboxes/usage Get sandbox resource usage

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/langsmith-sandboxes-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

langsmith-sandboxes-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: LangSmith access_policies Sandboxes API
  description: 'The LangSmith API is used to programmatically create and manage LangSmith resources.


    ## Host

    https://api.smith.langchain.com


    ## Authentication

    To authenticate with the LangSmith API, set the `X-Api-Key` header

    to a valid [LangSmith API key](https://docs.langchain.com/langsmith/create-account-api-key#create-an-api-key).


    '
  version: 0.1.0
servers:
- url: /
tags:
- name: sandboxes
paths:
  /auth/sandbox-access:
    get:
      security:
      - API Key: []
      - Tenant ID: []
      - Bearer Auth: []
      description: Combines authn + per-sandbox authz for runtime access. Returns the caller's PublicAuthInfo on allow (HTTP 200) or a 403 with the deny reason on deny.
      tags:
      - sandboxes
      summary: Get sandbox access decision
      parameters:
      - description: Sandbox claim UUID
        name: sandbox_id
        in: query
        required: true
        schema:
          type: string
          title: Sandbox Id
      - description: 'Runtime action: exec | file | tunnel | proxy'
        name: action
        in: query
        required: true
        schema:
          type: string
          title: Action
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/authn.PublicAuthInfo'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '403':
          description: 'sandbox access denied: <reason>'
          content:
            application/json:
              schema:
                type: string
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
  /v2/sandboxes/boxes:
    get:
      security:
      - API Key: []
      - Tenant ID: []
      - Bearer Auth: []
      - X-Service-Key: []
      description: List sandbox claims for the authenticated tenant, with optional filtering, sorting, and pagination.
      tags:
      - sandboxes
      summary: List sandbox claims
      parameters:
      - description: Maximum number of results
        name: limit
        in: query
        schema:
          type: integer
          default: 50
          title: Limit
      - description: Pagination offset
        name: offset
        in: query
        schema:
          type: integer
          default: 0
          title: Offset
      - description: Filter by name substring
        name: name_contains
        in: query
        schema:
          type: string
          title: Name Contains
      - description: Filter by status (provisioning, ready, failed, stopped, deleting)
        name: status
        in: query
        schema:
          type: string
          title: Status
      - description: Sort column (name, status, created_at)
        name: sort_by
        in: query
        schema:
          type: string
          default: created_at
          title: Sort By
      - description: Sort direction (asc, desc)
        name: sort_direction
        in: query
        schema:
          type: string
          default: desc
          title: Sort Direction
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ClaimListResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
    post:
      security:
      - API Key: []
      - Tenant ID: []
      - Bearer Auth: []
      - X-Service-Key: []
      description: Create a new sandbox from a snapshot. The snapshot may be identified by `snapshot_id` (UUID) or by `snapshot_name` (tenant-scoped unique name); exactly one must be set.
      tags:
      - sandboxes
      summary: Create a sandbox claim
      parameters: []
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ClaimResponse'
        '400':
          description: Snapshot not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '409':
          description: Name already exists
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '422':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '429':
          description: Quota exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '500':
          description: Sandbox creation failed or internal error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '504':
          description: Sandbox did not become ready in time
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/sandboxes.CreateClaimPayload'
  /v2/sandboxes/boxes/batch-delete:
    post:
      security:
      - API Key: []
      - Tenant ID: []
      - Bearer Auth: []
      description: Delete multiple sandbox claims by name or UUID in a single request.
      tags:
      - sandboxes
      summary: Batch delete sandbox claims
      parameters: []
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.BatchDeleteResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/sandboxes.BatchDeleteRequest'
  /v2/sandboxes/boxes/{name}:
    get:
      security:
      - API Key: []
      - Tenant ID: []
      - Bearer Auth: []
      - X-Service-Key: []
      description: Retrieve a sandbox claim by name. Stale provisioning claims are auto-failed.
      tags:
      - sandboxes
      summary: Get a sandbox claim
      parameters:
      - description: Sandbox claim display name
        name: name
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ClaimResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
    delete:
      security:
      - API Key: []
      - Tenant ID: []
      - Bearer Auth: []
      - X-Service-Key: []
      description: Delete a sandbox claim by name or UUID. Tears down the sandbox runtime and removes the DB record.
      tags:
      - sandboxes
      summary: Delete a sandbox claim
      parameters:
      - description: Sandbox claim display name or UUID
        name: name
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          description: No content
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
    patch:
      security:
      - API Key: []
      - Tenant ID: []
      - Bearer Auth: []
      - X-Service-Key: []
      description: Update a sandbox claim's display name. The name must be unique within the tenant.
      tags:
      - sandboxes
      summary: Update a sandbox claim
      parameters:
      - description: Current sandbox claim display name
        name: name
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ClaimResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '409':
          description: Name already exists
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '422':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/sandboxes.UpdateClaimPayload'
  /v2/sandboxes/boxes/{name}/service-url:
    post:
      security:
      - API Key: []
      - Tenant ID: []
      - Bearer Auth: []
      description: Create a short-lived JWT for accessing an HTTP service running on a specific port inside a sandbox. Returns a browser_url (sets auth cookie via redirect), a service_url (for use with the X-Langsmith-Sandbox-Service-Token header), the raw token, and its expiry.
      tags:
      - sandboxes
      summary: Generate a service access token
      parameters:
      - description: Sandbox claim display name
        name: name
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ServiceURLResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '422':
          description: Unprocessable Entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '501':
          description: Not Implemented
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/sandboxes.ServiceURLPayload'
  /v2/sandboxes/boxes/{name}/snapshot:
    post:
      security:
      - API Key: []
      - Tenant ID: []
      - Bearer Auth: []
      description: Create a snapshot by capturing the current state of a sandbox or promoting an existing checkpoint.
      tags:
      - sandboxes
      summary: Capture a snapshot from a sandbox
      parameters:
      - description: Sandbox claim display name
        name: name
        in: path
        required: true
        schema:
          type: string
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.SnapshotResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '422':
          description: Unprocessable Entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/sandboxes.CaptureSnapshotPayload'
  /v2/sandboxes/boxes/{name}/start:
    post:
      security:
      - API Key: []
      - Tenant ID: []
      - Bearer Auth: []
      description: Start a stopped or failed sandbox. This endpoint is not idempotent.
      tags:
      - sandboxes
      summary: Start a sandbox
      parameters:
      - description: Sandbox claim display name
        name: name
        in: path
        required: true
        schema:
          type: string
      responses:
        '202':
          description: Accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ClaimResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
  /v2/sandboxes/boxes/{name}/status:
    get:
      security:
      - API Key: []
      - Tenant ID: []
      - Bearer Auth: []
      - X-Service-Key: []
      description: Retrieve the lightweight status of a sandbox claim for polling.
      tags:
      - sandboxes
      summary: Get sandbox claim status
      parameters:
      - description: Sandbox claim display name
        name: name
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ClaimStatusResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
  /v2/sandboxes/boxes/{name}/stop:
    post:
      security:
      - API Key: []
      - Tenant ID: []
      - Bearer Auth: []
      description: Stop a ready sandbox. This endpoint is not idempotent; the filesystem is preserved for later restart.
      tags:
      - sandboxes
      summary: Stop a sandbox
      parameters:
      - description: Sandbox claim display name
        name: name
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          description: Sandbox stopped
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
  /v2/sandboxes/snapshots:
    get:
      security:
      - API Key: []
      - Tenant ID: []
      - Bearer Auth: []
      description: List sandbox snapshots for the authenticated tenant, with optional filtering, sorting, and pagination.
      tags:
      - sandboxes
      summary: List snapshots
      parameters:
      - description: Maximum number of results
        name: limit
        in: query
        schema:
          type: integer
          default: 50
          title: Limit
      - description: Pagination offset
        name: offset
        in: query
        schema:
          type: integer
          default: 0
          title: Offset
      - description: Filter by name substring
        name: name_contains
        in: query
        schema:
          type: string
          title: Name Contains
      - description: Filter by status (building, ready, failed, deleting)
        name: status
        in: query
        schema:
          type: string
          title: Status
      - description: Sort column (name, status, created_at)
        name: sort_by
        in: query
        schema:
          type: string
          default: created_at
          title: Sort By
      - description: Sort direction (asc, desc)
        name: sort_direction
        in: query
        schema:
          type: string
          default: desc
          title: Sort Direction
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.SnapshotListResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
    post:
      security:
      - API Key: []
      - Tenant ID: []
      - Bearer Auth: []
      description: Create a snapshot from a Docker image (async build).
      tags:
      - sandboxes
      summary: Create a snapshot
      parameters: []
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.SnapshotResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/sandboxes.CreateSnapshotPayload'
  /v2/sandboxes/snapshots/{snapshot_id}:
    get:
      security:
      - API Key: []
      - Tenant ID: []
      - Bearer Auth: []
      description: Get a sandbox snapshot by ID.
      tags:
      - sandboxes
      summary: Get a snapshot
      parameters:
      - description: Snapshot UUID
        name: snapshot_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.SnapshotResponse'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
    delete:
      security:
      - API Key: []
      - Tenant ID: []
      - Bearer Auth: []
      description: Delete a snapshot by ID. The underlying storage is reclaimed asynchronously.
      tags:
      - sandboxes
      summary: Delete a snapshot
      parameters:
      - description: Snapshot UUID
        name: snapshot_id
        in: path
        required: true
        schema:
          type: string
      responses:
        '204':
          description: Snapshot deleted
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
  /v2/sandboxes/usage:
    get:
      security:
      - API Key: []
      - Tenant ID: []
      - Bearer Auth: []
      - X-Service-Key: []
      description: Get current sandbox resource usage and quota limits for the workspace
      tags:
      - sandboxes
      summary: Get sandbox resource usage
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.UsageResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/sandboxes.ErrorResponse'
      parameters: []
components:
  schemas:
    sandboxes.BatchDeleteSkipped:
      type: object
      properties:
        name:
          type: string
        reason:
          type: string
    authn.PublicAuthInfo:
      type: object
      properties:
        ls_user_id:
          type: string
        organization_id:
          type: string
        tenant_id:
          type: string
        user_email:
          type: string
        user_id:
          type: string
    sandboxes.SnapshotResponse:
      type: object
      properties:
        created_at:
          type: string
        created_by:
          type: string
        docker_image:
          type: string
        fs_capacity_bytes:
          type: integer
        fs_used_bytes:
          type: integer
        id:
          type: string
        image_digest:
          type: string
        name:
          type: string
        registry_id:
          type: string
        source_sandbox_id:
          type: string
        status:
          type: string
        status_message:
          type: string
        updated_at:
          type: string
    sandboxes.AccessControl:
      type: object
      properties:
        allow_list:
          type: array
          items:
            type: string
        deny_list:
          type: array
          items:
            type: string
    sandboxes.SnapshotListResponse:
      type: object
      properties:
        offset:
          type: integer
        snapshots:
          type: array
          items:
            $ref: '#/components/schemas/sandboxes.SnapshotResponse'
    sandboxes.CaptureSnapshotPayload:
      type: object
      required:
      - name
      properties:
        checkpoint:
          description: if omitted, creates a fresh checkpoint from the running VM
          type: string
        name:
          type: string
    sandboxes.ClaimListResponse:
      type: object
      properties:
        offset:
          type: integer
        sandboxes:
          type: array
          items:
            $ref: '#/components/schemas/sandboxes.ClaimResponse'
    sandboxes.Callback:
      type: object
      required:
      - match_hosts
      - ttl_seconds
      - url
      properties:
        full_request:
          type: boolean
        match_hosts:
          type: array
          minItems: 1
          items:
            type: string
        request_headers:
          type: array
          items:
            $ref: '#/components/schemas/sandboxes.ProxyHeader'
        ttl_seconds:
          type: integer
          maximum: 3600
          minimum: 60
        url:
          type: string
    sandboxes.ErrorResponse:
      type: object
      properties:
        detail:
          type: object
          properties:
            error:
              type: string
            error_id:
              type: string
            message:
              type: string
    sandboxes.ProxyRule:
      type: object
      required:
      - match_hosts
      - name
      properties:
        enabled:
          type: boolean
        headers:
          type: array
          items:
            $ref: '#/components/schemas/sandboxes.ProxyHeader'
        match_hosts:
          type: array
          minItems: 1
          items:
            type: string
        match_paths:
          type: array
          items:
            type: string
        name:
          type: string
    sandboxes.CreateClaimPayload:
      type: object
      properties:
        delete_after_stop_seconds:
          type: integer
        fs_capacity_bytes:
          type: integer
        idle_ttl_seconds:
          type: integer
        mem_bytes:
          type: integer
        name:
          type: string
        proxy_config:
          $ref: '#/components/schemas/sandboxes.ProxyConfig'
        snapshot_id:
          type: string
        snapshot_name:
          type: string
        vcpus:
          type: integer
    sandboxes.UsageResponse:
      type: object
      properties:
        cpu_limit_millicores:
          type: integer
        cpu_used_millicores:
          type: integer
        memory_limit_bytes:
          type: integer
        memory_used_bytes:
          type: integer
        pools_count:
          type: integer
        registries_count:
          type: integer
        sandbox_direct_count:
          type: integer
        sandbox_pool_replicas_count:
          type: integer
        sandbox_running_count:
          type: integer
        sandbox_stopped_count:
          type: integer
        sandboxes_limit:
          type: integer
        sandboxes_used:
          type: integer
        snapshots_count:
          type: integer
        templates_count:
          type: integer
    sandboxes.UpdateClaimPayload:
      type: object
      properties:
        delete_after_stop_seconds:
          type: integer
        fs_capacity_bytes:
          type: integer
        idle_ttl_seconds:
          type: integer
        mem_bytes:
          type: integer
        name:
          type: string
        proxy_config:
          $ref: '#/components/schemas/sandboxes.ProxyConfig'
        vcpus:
          type: integer
    sandboxes.HeaderType:
      type: string
      enum:
      - plaintext
      - opaque
      - workspace_secret
      x-enum-varnames:
      - HeaderTypePlaintext
      - HeaderTypeOpaque
      - HeaderTypeWorkspaceSecret
    sandboxes.ServiceURLPayload:
      type: object
      properties:
        expires_in_seconds:
          type: integer
        port:
          type: integer
    sandboxes.BatchDeleteResponse:
      type: object
      properties:
        deleted:
          type: array
          items:
            type: string
        skipped:
          type: array
          items:
            $ref: '#/components/schemas/sandboxes.BatchDeleteSkipped'
    sandboxes.ClaimResponse:
      type: object
      properties:
        created_at:
          type: string
        created_by:
          type: string
        dataplane_url:
          type: string
        delete_after_stop_seconds:
          type: integer
        fs_capacity_bytes:
          type: integer
        id:
          type: string
        idle_ttl_seconds:
          type: integer
        mem_bytes:
          type: integer
        name:
          type: string
        proxy_config:
          $ref: '#/components/schemas/sandboxes.ProxyConfig'
        size_class:
          type: string
        snapshot_id:
          type: string
        status:
          type: string
        status_message:
          type: string
        stopped_at:
          type: string
        updated_at:
          type: string
        updated_by:
          type: string
        vcpus:
          type: integer
    sandboxes.ProxyConfig:
      type: object
      properties:
        access_control:
          $ref: '#/components/schemas/sandboxes.AccessControl'
        callbacks:
          type: array
          items:
            $ref: '#/components/schemas/sandboxes.Callback'
        no_proxy:
          type: array


# --- truncated at 32 KB (33 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/langsmith/refs/heads/main/openapi/langsmith-sandboxes-api-openapi.yml