Skip to main content
PUT
/
api
/
v1
/
variables
/
{name}
Replace a variable value
curl --request PUT \
  --url https://api.example.com/api/v1/variables/{name} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "value": "<string>",
  "description": "<string>"
}
'
{
  "name": "DEPLOY_ENV",
  "value": "production",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "description": "<string>"
}

Authorizations

​
Authorization
string
header
required

Raw dev token passed as Authorization: Bearer fabro_dev_... when server.auth.methods includes dev-token.

Path Parameters

​
name
string
required

Variable name.

Pattern: ^[A-Za-z_][A-Za-z0-9_]*$

Body

application/json

Request to update a variable.

​
value
string
required

Replacement value. Empty values are allowed.

​
description
string

Optional operator-facing description. Omitted descriptions preserve the existing value.

Response

Variable updated

Non-sensitive variable available for run config interpolation.

​
name
string
required

Env-style variable name.

Pattern: ^[A-Za-z_][A-Za-z0-9_]*$
Example:

"DEPLOY_ENV"

​
value
string
required

Variable value.

Example:

"production"

​
created_at
string<date-time>
required

When the variable was first stored.

​
updated_at
string<date-time>
required

When the variable was last updated.

​
description
string

Optional operator-facing description of the variable.