Skip to main content
Variables let you store configuration once and reuse it across flows and agents instead of hardcoding values. Secrets are variables whose value is write-only — you can set and reference them, but they’re never shown again after saving, so API keys and tokens stay safe.

​
Variables vs. secrets

Values are typed — string, number, boolean, json, datetime, or file — so a flow gets the right shape when it reads one.

​
Scopes

  • Workspace variables — shared across everything in a workspace. Manage them in workspace settings.
  • Workflow variables — scoped to a single flow, for values that only that flow needs.

​
Using them

In flows

Reference a variable from a node’s config instead of typing a literal, so one change updates every flow that uses it.

For credentials

Store an API key as a secret, then reference it where a node or integration needs it — the value never appears in the flow definition.

Programmatically

List, create, update, and delete variables via the SDK and REST API. Secret values are stripped from responses.
Because secret values can’t be read back, keep the source of truth for a credential wherever you generated it. To rotate, set a new value on the secret.