Variables

Create a variable

Changed on

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

Request

  • Base URL
    https://demo.supercheck.dev
  • Auth
    HTTP bearer

Request body

keystring required

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

valuestring required
isSecretboolean
descriptionstring

Example request

{
  "key": "API_BASE_URL",
  "value": "https://api.example.com"
}

Response

Variable created

idstring uuid
projectIdstring uuid
keystring

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).

type'variable' | 'secret' | 'file'

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

valuestring

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

isSecretboolean
descriptionstring nullable
createdByNamestring nullable
createdByImagestring nullable
fileNamestring nullable
fileSizeinteger nullable
mimeTypestring nullable
createdAtstring date-time
updatedAtstring date-time nullable

Changes

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • breaking

      the request property's minLength was increased from 0 to 4

    • breaking

      added the pattern ^[A-Z][A-Z0-9_]*$ to the request property

    • warning

      the request property's maxLength was set to 20

    • warning

      the request property's maxLength was set to 10000