ReferenceAPI

Update a variable

Update a variable's value under the same id.

PATCH https://api.nevia.cloud/v1/variables/{var}

curl -X PATCH "https://api.nevia.cloud/v1/variables/01d4cnjr0f5h7k9m2p4r6t8v0x2" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "value": "us-east-1"
  }'

{
  "variable": {
    "id": "01d4cnjr0f5h7k9m2p4r6t8v0x2",
    "workspace": "01d4cnjjq40hnnh0nwmkg35nv2h",
    "name": "DATABASE_PASSWORD",
    "created_by": "01d4cnjmn4fbb1r5btxb5mypv62",
    "updated_by": "01d4cnjmn4fbb1r5btxb5mypv62",
    "created_at": "2026-09-10T12:34:56Z",
    "updated_at": "2026-09-10T12:34:56Z",
    "deleted_at": "2026-09-10T12:34:56Z",
    "value": "eu-west-1"
  },
  "operations": [
    "01d4cnjm89yk0r3xtv80dy0x7by"
  ]
}

Authorization

bearerAuth

Authorization Bearer <token>

Send the token in the Authorization: Bearer <token> header. See Authenticate.

In: header

Path Parameters

var* string

Variable id: 27 lowercase letters and digits.

Match ^[A-Za-z0-9_-]{1,64}$

Header Parameters

Idempotency-Key? string

Optional retry key, kept 24 hours

Length 1 <= length <= 255

Request Body

application/json

New value for the variable. To rename, delete and create

Behavior

Each computer's next exec sees the new value. Running processes keep the old one.

Response

application/json

The variable, with operations empty.

Get a variable

Get a variable with its value, which every workspace viewer may read.

Delete a variable

Delete a variable, including one that computers reference.