v1

latestOpenAPI 3.1.0AGPL-3.02026-07-17644498.1 KB
Variables

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

Request body

keystring required
valuestring required
isSecretboolean
descriptionstring

Example request

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

Response

Variable created

idstring uuid
projectIdstring uuid
keystring
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
fileNamestring nullable
fileSizeinteger nullable
mimeTypestring nullable
createdAtstring date-time
updatedAtstring date-time nullable