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

# Get sandbox configuration

> Gets the regions where you can create a sandbox.

Configuration is the same for every team, so the request doesn't select a team.
Use a returned region when you [create a sandbox](/sandboxes/manage#create-a-sandbox).


## OpenAPI

````yaml get /v1/sandboxes/configuration
openapi: 3.1.0
info:
  description: REST API for management of Baseten resources
  title: Baseten management API
  version: 1.0.0
servers:
  - url: https://api.baseten.co
security:
  - BearerAuth: []
paths:
  /v1/sandboxes/configuration:
    get:
      tags:
        - Sandboxes
      summary: Get sandbox configuration
      description: >-
        Return available Carbon-compatible sandbox regions. Configuration is the
        same for every team, so no team is selected. Only enabled regions
        supporting Carbon are returned. This describes regional capability, not
        the runtime selected for a particular team or sandbox. Region
        configuration is cached for up to 30 seconds.
      operationId: GetSandboxConfiguration
      responses:
        '200':
          description: Successful operation.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetSandboxConfigurationResponseV1'
              example:
                regions:
                  - name: us-was-1
                    country: us
                    continent: na
                    location: Washington
                    info_generation: CARBON
        '400':
          $ref: '#/components/responses/SandboxError400'
        '401':
          $ref: '#/components/responses/SandboxError401'
        '403':
          $ref: '#/components/responses/SandboxError403'
        '429':
          $ref: '#/components/responses/SandboxError429'
        '500':
          $ref: '#/components/responses/SandboxError500'
components:
  schemas:
    GetSandboxConfigurationResponseV1:
      type: object
      required:
        - regions
      properties:
        regions:
          type: array
          description: >-
            Available Carbon-compatible regions, sorted by name. Empty when none
            are available.
          items:
            $ref: '#/components/schemas/SandboxRegionV1'
    SandboxRegionV1:
      type: object
      required:
        - name
        - country
        - continent
        - location
        - info_generation
      properties:
        name:
          type: string
          description: Public region identifier to use when creating a sandbox.
          example: us-was-1
        country:
          type: string
          description: Country code.
          example: us
        continent:
          type: string
          description: Continent code.
          example: na
        location:
          type: string
          description: Region location.
          example: Washington
        info_generation:
          type: string
          description: >-
            Runtime generation supported by this region, using the public name
            CARBON. Actual runtime selection depends on the team and sandbox
            configuration.
          enum:
            - CARBON
  responses:
    SandboxError400:
      description: >-
        Invalid request. Returns a JSON error with code, message, and optional
        details.
      content:
        application/json:
          example:
            code: INVALID_REQUEST
            message: One or more request parameters are invalid.
            details:
              request_id: a3b7c4d2-91e6-4f08-9b5a-2c6d7e8f1043
    SandboxError401:
      description: >-
        Missing or invalid authentication. Returns a JSON error with code,
        message, and optional details.
      content:
        application/json:
          example:
            code: UNAUTHORIZED
            message: Provide a valid authentication token in the Authorization header.
            details:
              header: Authorization
    SandboxError403:
      description: >-
        Insufficient permissions. Returns a JSON error with code, message, and
        optional details.
      content:
        application/json:
          example:
            code: FORBIDDEN
            message: >-
              This authentication token does not grant permission to perform
              this operation.
            details:
              request_id: a3b7c4d2-91e6-4f08-9b5a-2c6d7e8f1043
    SandboxError429:
      description: >-
        Request limit exceeded. Returns a JSON error with code, message, and
        optional details.
      content:
        application/json:
          example:
            code: RATE_LIMITED
            message: Too many requests. Try again in 30 seconds.
            details:
              retry_after_seconds: 30
    SandboxError500:
      description: >-
        Internal server error. Returns a JSON error with code, message, and
        optional details.
      content:
        application/json:
          example:
            code: INTERNAL_ERROR
            message: The request could not be completed. Try again later.
            details:
              request_id: a3b7c4d2-91e6-4f08-9b5a-2c6d7e8f1043
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        Send `Authorization: Bearer <api_key>`. The legacy `Authorization:
        Api-Key <api_key>` scheme is also accepted.

````