> ## Documentation Index > Fetch the complete documentation index at: https://docs.replicas.dev/llms.txt > Use this file to discover all available pages before exploring further. # Create environment variable > Keys must start with a letter or underscore and contain only letters, digits, and underscores, and are unique per environment. Values are encrypted at rest. Personal overlays can override an inherited key only when it has `personal_override_allowed: true`. ## OpenAPI ````yaml /openapi.json post /v1/environments/{environment_id}/variables openapi: 3.1.0 info: title: Replicas API version: 2.0.0 description: >- Create and control workspaces, and manage the environments, automations, and learnings they run with. servers: - url: https://api.replicas.dev description: Production API security: - apiKey: [] tags: - name: Replica description: >- A replica is a Replicas workspace: a cloud sandbox where a coding agent works on your repositories. - name: Chats description: Manage the agent chats inside a replica. - name: Message queue description: Messages waiting for the agent to finish its turn. - name: Commands and terminals description: Run commands and open shells in a replica. - name: Pull requests description: Inspect and act on pull requests a replica opened. - name: Previews description: Public URLs for ports in a replica. - name: Canvas description: Plans, reports, and other files agents produce. - name: Sharing description: Add replicas to members' Shared view. - name: Environments description: >- Environments define what a workspace starts with. The `global` environment applies to every workspace. - name: Environment variables description: Variables injected into workspaces. - name: Environment files description: Files written into workspaces. - name: Environment skills description: Agent skills installed into workspaces. - name: Environment MCPs description: MCP servers available to workspace agents. - name: Hooks description: Scripts that run when warm pool snapshots build and when workspaces start. - name: Warm pools description: Pre-built workspaces that start faster. - name: Automations description: Run agents on schedules and events. - name: Repositories description: Repositories and repository sets connected to the organization. - name: Learnings description: Organization skills every workspace agent loads. - name: Agent credentials description: >- API keys and endpoints that coding agents use. Connect Claude, Codex, and Muse subscriptions with the CLI. - name: Plugins description: Connect integrations that workspace agents can use. - name: Organization description: Who you are and who is in your organization. - name: Media description: Screenshots, recordings, and other files workspaces produce. - name: Slack description: Route Slack threads to workspaces. - name: Workspace identity description: OIDC keys for verifying workspace identity tokens. paths: /v1/environments/{environment_id}/variables: post: tags: - Environment variables summary: Create environment variable description: >- Keys must start with a letter or underscore and contain only letters, digits, and underscores, and are unique per environment. Values are encrypted at rest. Personal overlays can override an inherited key only when it has `personal_override_allowed: true`. operationId: createEnvironmentVariable parameters: - name: environment_id in: path required: true description: >- Environment UUID, or the literal string `global` for the org's Global environment. schema: type: string - $ref: '#/components/parameters/ApiVersion' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/CreateEnvironmentVariableRequest' responses: '201': description: Variable created content: application/json: schema: $ref: '#/components/schemas/EnvironmentVariableResponse' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': description: Admin access required to change personal override policy content: application/json: schema: $ref: '#/components/schemas/Error' '409': $ref: '#/components/responses/Conflict' '500': $ref: '#/components/responses/InternalServerError' components: parameters: ApiVersion: name: X-Replicas-Api-Version in: header description: >- API version. `2026-10-07` returns `snake_case` responses. See [versioning](/features/api#versioning). required: false schema: type: string enum: - '2026-10-07' schemas: CreateEnvironmentVariableRequest: type: object description: Request body for creating an environment variable. properties: key: type: string description: Variable name value: type: string description: Variable value (encrypted at rest) personal_override_allowed: type: boolean description: >- Team/Global variables only. Allows source-backed personal environments to override this inherited key. required: - key - value EnvironmentVariableResponse: type: object properties: environment_variable: $ref: '#/components/schemas/EnvironmentVariable' required: - environment_variable Error: type: object properties: error: type: string description: Error message details: type: - string - 'null' description: Additional error details code: type: string description: Machine-readable error code when available required: - error EnvironmentVariable: type: object description: >- An environment variable. Values are encrypted at rest and decrypted on read. properties: id: type: string format: uuid organization_id: type: string format: uuid environment_id: type: string format: uuid key: type: string description: Variable name (e.g. `DATABASE_URL`) value: type: string description: Variable value (returned in plaintext) personal_override_allowed: type: boolean description: >- Whether source-backed personal environments may override this inherited key created_at: type: string format: date-time updated_at: type: string format: date-time required: - id - organization_id - environment_id - key - value - personal_override_allowed - created_at - updated_at responses: BadRequest: description: Bad request - Missing or invalid parameters content: application/json: schema: $ref: '#/components/schemas/Error' Unauthorized: description: Unauthorized - Invalid or missing API key content: application/json: schema: $ref: '#/components/schemas/Error' Conflict: description: >- Conflict - Resource already exists or operation conflicts with current state content: application/json: schema: $ref: '#/components/schemas/Error' InternalServerError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: apiKey: type: http scheme: bearer description: Organization or personal API key from **Settings → API Keys**. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.