Skip to main content
Environment variables store configuration values—such as API keys, endpoint URLs, and tokens—that the app references at runtime. Define a value once and reuse it across tools and workflows without hard-coding it. Key benefits:
  • Centralized management — Define values once; reference them anywhere in the app.
  • Secure storage — Sensitive values can be encrypted and hidden in the UI.
  • Environment-specific values — Override defaults per deployment environment.
Environment variables are accessible to both Code Tools and Workflow Tools.

​
View Environment Variables

Go to Settings > Variables to see all variables defined for the app.

​
Create an Environment Variable

  1. Go to Settings > Variables.
  2. Click + New Variable.
  3. Fill in the following fields:
    FieldDescription
    Variable NameUnique identifier for the variable.
    DescriptionBrief description of the variable’s purpose.
    Default ValueValue used unless overridden during deployment.
    EncryptionWhen enabled, the variable is encrypted and hidden in the UI.
    NamespaceLogical group for organizing related variables. Select an existing namespace or create a new one.
  4. Click Create.

​
Edit an Environment Variable

  1. In the Variables list, open the options menu for the variable.
  2. Select Edit.
  3. Update the fields as needed.
  4. Click Save.
Changes automatically propagate to all modules that reference the variable.

​
Delete an Environment Variable

Deleting a variable removes it permanently. The Platform doesn’t resolve the references to the deleted variable. To delete, open the options menu for the variable, and select Delete.
To remove a variable associated with a namespace, remove the namespace first.

​
Namespaces

A namespace is a logical group for organizing environment variables. Namespaces prevent naming conflicts and allow different modules to use variables with the same name independently.
BenefitDescription
OrganizationGroup related variables—such as those for authentication or third-party integrations.
Conflict preventionAvoid clashes when multiple modules need variables with identical names (for example, API_KEY).
Scoped accessOnly variables within an associated namespace are accessible to a tool.

​
Create and Manage a Namespace

  1. Click Manage Namespaces and select + Create Namespace.
  2. Fill in the following fields:
    FieldDescription
    NameUnique identifier for the namespace.
    DescriptionBrief description of the namespace’s purpose.
  3. Click Create.
To update or delete a namespace, open Options and select the action. Use Preview to view the variables and modules associated with the namespace.
You can’t delete a namespace that’s associated with a tool. You must remove all variables within the namespace to delete the namespace.

​
Access Environment Variables in Tools

To use an environment variable in a tool, the variable must belong to a namespace associated with that tool.
  1. Go to the tool. Click Options > Manage Namespaces.
  2. Associate the relevant namespace and click Save.
  3. Reference the variable in a script using the format env.<variable-name>. env is a reserved keyword.
  4. To reference the variable in other fields such as prompts or parameters, use the format {{env.<variable-name>}}.

​
Variable Lifecycle

Environment variables are defined at the app level and can hold different values per deployment environment.
StageBehavior
Variable creationA default value can be assigned. This value is used when new versions and environments are created.
New app versionAll existing variables carry forward. Review variables and defaults before proceeding.
New deployment environmentThe environment uses default values initially. Click Review Variables to override values for that environment.
Deploying an updated version to an existing environmentChoose to use default values or apply custom values for that deployment.

​
API Support

The Platform provides APIs to update environment variable values dynamically at runtime. Contact the Support Team for access.