Supercheck LogoSupercheck
Variables API

Create a variable

Create a new text or secret project variable. File-type variables are managed through the project UI upload workflow rather than this public JSON endpoint.

POST
/api/variables

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.

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
Defaultfalse
description?string

Response Body

Variable created

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 POST 'https://demo.supercheck.dev/api/variables' \  -H 'Content-Type: application/json' \  -d '{  "key": "string",  "value": "string"}'
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"}