Create input variable
Input Variables
Create Input Variable
Create a new User Defined input variable in the workspace’s registry. The variable key must be unique across the workspace’s own variables and the global System variables.
POST
Create input variable
Use this endpoint to create a new User Defined input variable in the workspace’s registry.
Endpoint
POST/input-variable/create
Content-Type: application/json
Authentication: Required (workspace auth)
Request Body
Response
Behavior
- The new variable is always created as User Defined (
IS_SYSTEM = 0) and active (STATUS = 1). variable_keymust be unique across both the workspace’s own variables and the global System variables — a key already used by either is rejected.typeis normalized to lowercase and validated against the allowed list before saving.
Error Cases
Example cURL
Headers
API token for authentication
Body
application/json
Unique key for the variable. Letters, numbers and underscore only, and must start with a letter or underscore.
Data type of the variable
Available options:
string, number, date, email, phone, name, amount, address, pincode, no_type Human-readable description of the variable

