Docs

Session variables

Set variable values for one session without changing workspace variables.

Session variables let you set placeholder values for one workflow run without editing workspace variables. Use them when each engagement needs its own targets, scope labels, or case IDs.

How session variables work

  • Session variables apply only to the current session (workflow run).
  • They override workspace values when both exist for the same name.
  • Workspace variable rows are not mutated — your shared library values stay unchanged.
  • When the session ends or becomes read-only, session variable edits are no longer allowed.

Workspace defaults toggle

On the session variables panel, Use workspace variables as defaults controls fallback behaviour:

ToggleBehaviour
OnNames without a session override use the current workspace variable value at resolve time.
OffOnly session overrides and explicit placeholders apply — workspace values are not filled in automatically.

Session overrides always win over workspace defaults when both are present.

Where to manage session variables

Open an active session and use the Session variables panel in the session runner. You can add, edit, or remove overrides for names referenced by the workflow.

For workspace-wide values shared across sessions, use the Variables page.

Sensitive values

Session variable values can be marked or detected as sensitive. Sensitive values may show a masked preview in the UI instead of plain text.

Masking is a UI safety aid, not encryption or access control. Treat session variables like any other workspace content — do not store secrets unless your organisation explicitly allows it.

Visibility

Session variables are scoped to the session you started. Other workspace members do not edit your session overrides through the session variables panel on your run.

Workspace variables remain shared with all workspace members who have access — see Variables.

Read-only sessions

When a session is completed, stopped, or tied to an archived workflow, the session variables panel is read-only. Existing values are preserved for review.