Supercheck LogoSupercheck
Variables API

Update a variable

Update an existing text or secret variable's key, value, secret flag, or description. File-type variables must be managed through the project UI upload workflow.

PUT
/api/variables/{id}

Authorization

bearerAuth
headerAuthorizationBearer <token>

Project-scoped CLI token (sck_live_* or sck_test_*) for documented API operations that accept bearer authentication. Interactive browser operations may require a session cookie. Trigger keys (sck_trigger_* / legacy job_*) are accepted only by job trigger endpoints.

Path Parameters

id*string

Variable ID

Formatuuid

Request Body

application/json
  1. body
key?string

Uppercase letters, digits, and underscores only; cannot use the SUPERCHECK_ prefix or reserved system names.

Match^[A-Z][A-Z0-9_]*$
Length4 <= length <= 20
value?string
Lengthlength <= 10000
isSecret?boolean
description?string

Response Body

Variable updated

application/json
  1. response
id?string
Formatuuid
projectId?string
Formatuuid
key?string

Variable key. Uppercase letters, digits, and underscores only; 4-20 characters; must not use the SUPERCHECK_ prefix or a reserved name (for example PATH, HOME).

Match^[A-Z][A-Z0-9_]*$
Length4 <= length <= 20
type?string

Variable type. File variables expose metadata in API responses; file contents are not returned.

Value in"variable""secret""file"
value?string

Plaintext for regular variables, redacted for secrets, and empty for file variables

isSecret?boolean
description?string
createdByName?string
createdByImage?string
fileName?string
fileSize?integer
mimeType?string
createdAt?string
Formatdate-time
updatedAt?string
Formatdate-time
Example Request
curl -X PUT 'https://demo.supercheck.dev/api/variables/497f6eca-6276-4993-bfeb-53cbbbba6f08' \  -H 'Content-Type: application/json' \  -d '{}'
Example Response
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "projectId": "5a8591dd-4039-49df-9202-96385ba3eff8",  "key": "string",  "type": "variable",  "value": "string",  "isSecret": true,  "description": "string",  "createdByName": "string",  "createdByImage": "string",  "fileName": "string",  "fileSize": 0,  "mimeType": "string",  "createdAt": "2019-08-24T14:15:22Z",  "updatedAt": "2019-08-24T14:15:22Z"}