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

# Rename a sandbox

> Sets the sandbox's human name, which is the `name` key of its metadata.
Set it at create time with `metadata: {"name": "..."}` and filter on it
with the ordinary metadata filter. Other metadata keys are left alone;
the sandbox ID stays the identifier. `""` removes the name.




## OpenAPI

````yaml /api-reference/anona-openapi.yaml put /v1/sandboxes/{sandboxID}/name
openapi: 3.0.3
info:
  title: Anona Compute API (Anona routes)
  version: 0.1.0
  description: >
    Routes the Anona Compute gateway serves next to the E2B-compatible API:

    live-view viewer tokens, SSH certificates, network policy, the credential

    vault, usage and billing, webhooks and telemetry export, thumbnails, preview
    links,

    public ports, pause when idle, template builds, and API key management.
servers:
  - url: https://api.compute.anonalabs.com
security:
  - ApiKeyAuth: []
  - BearerAuth: []
tags:
  - name: Live view
  - name: SSH
  - name: Sandbox access
  - name: Templates
  - name: Network
  - name: Credential vault
  - name: Usage and billing
  - name: Webhooks and telemetry
  - name: API keys
  - name: Service
paths:
  /v1/sandboxes/{sandboxID}/name:
    put:
      tags:
        - Sandbox access
      summary: Rename a sandbox
      description: |
        Sets the sandbox's human name, which is the `name` key of its metadata.
        Set it at create time with `metadata: {"name": "..."}` and filter on it
        with the ordinary metadata filter. Other metadata keys are left alone;
        the sandbox ID stays the identifier. `""` removes the name.
      operationId: setSandboxName
      parameters:
        - $ref: '#/components/parameters/sandboxID'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - name
              properties:
                name:
                  type: string
                  maxLength: 64
                  description: >-
                    1 to 64 letters, digits, spaces, dots, dashes or
                    underscores, starting with a letter or digit. Trimmed; ""
                    removes the name.
      responses:
        '200':
          description: The sandbox's name after the change.
          content:
            application/json:
              schema:
                type: object
                required:
                  - sandboxID
                  - name
                properties:
                  sandboxID:
                    type: string
                  name:
                    type: string
                    description: '"" when the sandbox has no name.'
        '400':
          $ref: '#/components/responses/BadRequest'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  parameters:
    sandboxID:
      name: sandboxID
      in: path
      required: true
      schema:
        type: string
  responses:
    BadRequest:
      description: The request body is invalid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    NotFound:
      description: >-
        Not found, or not yours (the answer is the same, so IDs cannot be
        probed).
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  schemas:
    Error:
      type: object
      required:
        - code
        - message
      properties:
        code:
          type: integer
          description: The HTTP status code.
        message:
          type: string
        error_code:
          type: string
          description: >-
            Machine-readable reason, on some errors (for example
            `invalid_request`).
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: >-
        An Anona Compute API key (`ac_` followed by lowercase hex; older keys
        start with `e2b_`).
    BearerAuth:
      type: http
      scheme: bearer
      description: 'The same API key, sent as `Authorization: Bearer ac_...`.'

````

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