Anon Keys6

Auth Admin9

Auth Configuration25

Authentication23

Database Backups9

Database Branches7

Database Queries10

Databases10

Durable Functions22

Frontends15

Functions17

Git Connections6

Locks5

Logs3

OAuth Authentication13

OAuth Configuration6

Project Access Tokens6

Project Imports8

Projects27

Realtime3

Sandboxes24

Service Keys5

Storage Admin2

Storage Buckets5

Storage Objects9

Storage Policies3

System6

Variables5

Verified Domains3

Variables

Update a variable

Changed on Oct 7, 2026

Updates a project-level environment variable and triggers asynchronous propagation to deployed functions and frontends in the project's configured regions.

put/projects/{id}/variables/{name}

Request

Base URL: https://api.volcano.dev
URL: https://api.volcano.dev/projects/{id}/variables/{name}
Auth: one of:
- HTTP bearer
- HTTP bearer

Path parameters

idstring uuid required

Project ID

namestring required

Variable name. Function runtime names such as AWS_REGION are reserved and cannot be updated.

Request body

sharedboolean

Include this name in the project's shared function variables. Omission preserves existing membership; new variables default to true for legacy clients. Send false explicitly to create a non-shared variable.

valuestring required

Response

Variable updated

sharedboolean

frontend_sharedboolean

Whether this name is in the project's shared frontend-variable list.

idstring uuid required

project_idstring uuid required

namestring required

valuestring required

status'provisioning' | 'active' | 'failed'

Latest project variable propagation status, when a sync has run.

current_sync_idstring uuid

Identifier of the latest variable propagation sync.

provisioning_started_atstring date-time

Timestamp when the current variable propagation phase started.

deploy_source'git' | 'cli' | 'web' | 'api' | 'system' | 'unknown'

What initiated the latest variable propagation sync, when one has run.

created_atstring date-time required

updated_atstring date-time required

Changes

Oct 7, 202623e7875e7c4c Revision changes
- ○
  the endpoint scheme security ProjectAccessToken was added to the API
- ○
  added the non-success response with the status
- ○
  added the optional property to the response with the status
Sep 19, 20263a6f365f3f35 Revision changes
- ▲
  added the new path request parameter id
- ▲
  added the new path request parameter name
- ▲
  added the new required request property
- ▲
  the request's body type changed from no type to object
- ▲
  the response's body type changed from no type to object for status
- ▲
  the response's body type changed from no type to object for status
- ○
  added the new optional request property
- ○
  added the non-success response with the status
- ○
  added the optional property to the response with the status
- ○
  added the optional property to the response with the status
- ○
  added the optional property to the response with the status
- ○
  added the optional property to the response with the status
- ○
  added the optional property to the response with the status
- ○
  added the optional property to the response with the status
- ○
  added the required property to the response with the status
- ○
  added the required property to the response with the status
- ○
  added the required property to the response with the status
- ○
  added the required property to the response with the status
- ○
  added the required property to the response with the status
- ○
  added the required property to the response with the status
- ○
  added the required property to the response with the status

Operation history (4 revisions)