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

# Update Settings



## OpenAPI

````yaml POST /io.pocketenv.sandbox.updateSandboxSettings
openapi: 3.1.0
info:
  title: AT Protocol XRPC API
  summary: >-
    An unofficial conversion of AT Protocol's lexicons to OpenAPI's schema
    format.
  version: 0.0.0
  license:
    name: MIT License
    identifier: MIT
servers:
  - url: https://api.pocketenv.io/xrpc/
    description: AT Protocol PDS XRPC server
  - url: https://api.pocketenv.io/xrpc/
    description: AT Protocol AppView XRPC server
security: []
tags:
  - name: io.pocketenv.actor
  - name: app.bsky.actor
  - name: io.pocketenv.file
  - name: io.pocketenv.port
  - name: io.pocketenv.publicKey
  - name: io.pocketenv.sandbox
  - name: io.pocketenv.secret
  - name: io.pocketenv.service
  - name: com.atproto.repo
  - name: io.pocketenv.variable
  - name: io.pocketenv.volume
paths:
  /io.pocketenv.sandbox.updateSandboxSettings:
    post:
      tags:
        - io.pocketenv.sandbox
      summary: Update sandbox settings
      operationId: io.pocketenv.sandbox.updateSandboxSettings
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  description: The name of the sandbox
                  minLength: 1
                description:
                  type: string
                  description: A description for the sandbox
                topics:
                  type: array
                  items:
                    type: string
                    maxLength: 50
                repo:
                  type: string
                  description: >-
                    A git repository URL to clone into the sandbox, e.g. a
                    GitHub/Tangled repo.
                  format: uri
                vcpus:
                  type: integer
                  minimum: 1
                memory:
                  type: integer
                  minimum: 1
                disk:
                  type: integer
                  minimum: 3
                readme:
                  type: string
                  description: A URI to a README for the sandbox.
                  format: uri
                secrets:
                  $ref: '#/components/schemas/io.pocketenv.secret.defs.secrets'
                variables:
                  $ref: '#/components/schemas/io.pocketenv.variable.defs.variables'
                files:
                  $ref: '#/components/schemas/io.pocketenv.file.defs.file'
                volumes:
                  $ref: '#/components/schemas/io.pocketenv.volume.defs.volumes'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: d0728d4e-cc23-437d-b175-dddef98b9219
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                  - message
                properties:
                  error:
                    type: string
                    oneOf:
                      - const: InvalidRequest
                      - const: ExpiredToken
                      - const: InvalidToken
                  message:
                    type: string
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                required:
                  - error
                  - message
                properties:
                  error:
                    const: AuthMissing
                  message:
                    type: string
      security:
        - Bearer: []
components:
  schemas:
    io.pocketenv.secret.defs.secrets:
      type: array
      items:
        $ref: '#/components/schemas/io.pocketenv.secret.defs.secret'
    io.pocketenv.variable.defs.variables:
      type: array
      items: 89f31892-ff98-4ad7-9c39-96957aff494f
    io.pocketenv.file.defs.file:
      type: object
      required:
        - path
        - content
      properties:
        sandboxId:
          type: string
          description: >-
            The ID of the sandbox to which the file belongs. This is used to
            associate the file with a specific sandbox environment.
        path:
          type: string
          description: >-
            The file path within the sandbox, e.g. '/app/config.json',
            '/home/user/.ssh/id_rsa', etc.
        content:
          type: string
          description: >-
            The content of the file. This will be written to the specified path
            within the sandbox. The content should be base64 encoded if it's
            binary data.
    io.pocketenv.volume.defs.volumes:
      type: array
      items:
        $ref: '#/components/schemas/io.pocketenv.volume.defs.volume'
    io.pocketenv.secret.defs.secret:
      type: object
      required:
        - name
        - value
      properties:
        sandboxId:
          type: string
          description: >-
            The ID of the sandbox to which the secret belongs. This is used to
            associate the secret with a specific sandbox environment.
        name:
          type: string
          description: Name of the secret, e.g. 'DATABASE_URL', 'SSH_KEY', etc.
        value:
          type: string
          description: >-
            Value of the secret. This will be encrypted at rest and redacted in
            any API responses.
    io.pocketenv.volume.defs.volume:
      type: object
      required:
        - name
      properties:
        sandboxId:
          type: string
          description: >-
            The ID of the sandbox to which the volume belongs. This is used to
            associate the volume with a specific sandbox environment.
        name:
          type: string
          description: Name of the volume, e.g. 'data-volume', 'logs', etc.
        path:
          type: string
          description: >-
            The path within the sandbox where the volume will be mounted, e.g.
            '/data', '/logs', etc.
        readOnly:
          type: boolean
          description: >-
            Whether the volume should be mounted as read-only within the
            sandbox. Defaults to false (read-write).
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer

````