Skip to main content

​
Overview

Variables store reusable non-secret values.

​
Using variables in expressions

Access a variable in expressions with: 
${{ VARS.<variable_name>.<key> }}

​
Variable fields

Each variable has these fields:
  • Name: a lowercase snake case name such as jira or api_config
  • Values: one or more key-value pairs
  • Environment: the Workflow environment where the variable applies

​
When to use variables

Use variables for non-sensitive values such as:
  • Base URLs
  • Project IDs
  • Queue names
  • Routing rules
  • Tenant-specific defaults
Use a secret for sensitive values.

​
Variable environments

Every variable belongs to a Workflow environment.
  • Default source: the workflow default environment in Workflows.
  • Override: per action in Actions control flow.
  • Fallback: default.

​
Access variables in agents

Agents can use variable expressions in tool arguments and integration configuration. Values are resolved during tool execution and are not fetched directly by the LLM provider. 
When you call Jira tools, use `${{ VARS.jira.base_url }}` as the base URL and `${{ VARS.jira.project_key }}` as the default project key.
  • See Secrets for sensitive values such as API keys, passwords, and certificates.
  • See Expressions for how expressions work across triggers, actions, secrets, and variables.