> ## Documentation Index > Fetch the complete documentation index at: https://docs.domino.ai/llms.txt > Use this file to discover all available pages before exploring further. # Rename an environment > Change the display name of an existing compute environment. The new name must be unique for the environment owner and cannot be blank. Required permissions: `EditEnvironment` Related: - GET /api/environments/v1/environments/{environmentId} (read current name and metadata) - PUT /api/environments/v1/environments/{environmentId}/description (update description) - DELETE /api/environments/v1/environments/{environmentId} (archive environment) ## OpenAPI ````yaml /api-specs/cloud/public-api.json put /api/environments/v1/environments/{environmentId}/name openapi: 3.0.3 info: title: Domino Public API description: Reference for Domino's public REST API endpoints. version: 6.4.0 x-catalog-key: nucleus servers: - url: https://mycluster.domino.tech description: >- Replace 'mycluster.domino.tech' with your Domino cluster hostname. For Domino Cloud customers, that is `your-subdomain`.domino.tech (e.g., acme.domino.tech). For self-hosted deployments, it is the hostname you reach the Domino UI at. security: [] tags: - name: Projects - name: Project templates - name: Workspaces - name: Jobs - name: HPC Jobs - name: Environments - name: Hardware Tiers - name: Datasets - name: Data Sources - name: GenAI - name: AI Systems - name: Apps - name: App versions - name: App instances - name: Model APIs - name: Registered models - name: Model deployment - name: Extensions - name: Cost and billing - name: Users and organizations - name: Service accounts - name: Personal Access Tokens - name: Personal Access Tokens (admin) - name: Audit Trail - name: Custom metrics - name: PPM - name: Model Monitoring models - name: Model Monitoring drift and quality - name: Model Monitoring settings - name: Model Monitoring authentication - name: Governance bundles - name: Governance policies - name: Governance evidence and results - name: Governance operations - name: NetApp Volumes - name: NetApp Volumes snapshots - name: NetApp Volumes filesystems - name: NetApp Volumes transfers - name: Tags - name: Properties externalDocs: description: OpenAPI url: https://swagger.io/resources/open-api/ paths: /api/environments/v1/environments/{environmentId}/name: put: tags: - Environments summary: Rename an environment description: > Change the display name of an existing compute environment. The new name must be unique for the environment owner and cannot be blank. Required permissions: `EditEnvironment` Related: - GET /api/environments/v1/environments/{environmentId} (read current name and metadata) - PUT /api/environments/v1/environments/{environmentId}/description (update description) - DELETE /api/environments/v1/environments/{environmentId} (archive environment) operationId: updateEnvironmentName parameters: - description: > Domino environment ID (24-character hex string). Obtain from GET /api/environments/beta/environments, GET /api/environments/v1/environments/{environmentId}, or the environment details page URL. in: path name: environmentId required: true schema: example: 623132867a0af0281c01a69c type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/UpdateEnvironmentNameV1' description: New environment name required: true responses: '200': description: Name updated. '400': description: > Invalid request. Common causes: - `name` is missing, empty, or whitespace-only. - Another environment owned by the same user already has this name. Choose a different name or verify uniqueness with GET /api/environments/beta/environments. '401': $ref: '#/components/responses/401' '403': description: | Caller lacks `EditEnvironment` permission for this environment. '404': description: > `environmentId` not found or not visible to the caller. Verify the ID from GET /api/environments/v1/environments/{environmentId}. '500': $ref: '#/components/responses/500' security: - DominoApiKey: [] - BearerAuthentication: [] components: schemas: UpdateEnvironmentNameV1: properties: name: description: >- New environment name. Must contain at least one non-whitespace character and be unique among environments owned by the same user. Leading and trailing whitespace is trimmed. type: string required: - name type: object ErrorV1: properties: code: description: Machine-readable error code. example: NOT_FOUND type: string message: description: Human-readable description of the error. example: The requested HPC Job could not be found. type: string required: - message type: object responses: '401': content: application/json: example: code: UNAUTHORIZED message: Authentication is required to access this resource. schema: $ref: '#/components/schemas/ErrorV1' description: Unauthorized - authentication is required or has failed. '500': content: application/json: schema: properties: error: type: string type: object description: Internal Server Error securitySchemes: DominoApiKey: type: apiKey in: header name: X-Domino-Api-Key BearerAuthentication: type: apiKey name: Authorization in: header ```` ## Related topics - [Attempts to rename file or directory](/api-reference/datasets/attempts-to-rename-file-or-directory.md) - [Create a Domino Environment](/cloud/platform-capabilities/core-concepts/compute-environments/manage-compute-environments/3-create-an-environment.md) - [Attempts to rename volume file or directory](/api-reference/netapp-volumes/attempts-to-rename-volume-file-or-directory.md) - [Clean your Environment catalog](/cloud/admin/platform-configuration/manage-compute-environments/clean-environment-catalog.md)