Input Variables
List Input Variables
Retrieve a paginated list of input variables for the workspace (System + User Defined), including where each variable is currently used and whether it can be edited or deleted.
GET
List input variables
Use this endpoint to retrieve a paginated list of input variables for the workspace, including where each variable is currently used.
Endpoint
GET/input-variable/list
Authentication: Required (workspace auth)
Query Parameters
Variable Types
Response
Behavior
- Returns the workspace’s own User Defined variables plus the global System variables (
COMPANY_ID = 0,WORKSPACE_ID = 0), so built-in variables show up in every workspace’s list. - Results are sorted System variables first, then User Defined, both by ascending ID.
agent_typefilters out System variables that don’t apply to that agent type. Currentlymobile_nois excluded whenagent_typeis2(Chat) or4(General) — Voice agents (3) keep it.used_inis computed by scanning every non-deleted audience’s saved variable keys and every non-deleted agent flow’smetadata_inputdeclarations, so it reflects live usage at request time.- A variable can only be edited or deleted when it is User Defined and not referenced by any agent or audience — otherwise
show_edit/show_deleteare0and the corresponding*_descriptionfield explains why.

