AI Workforce OneHQDocs

Secrets and variables

Give your sessions the keys, tokens and settings they need. Secrets are encrypted and masked; variables are plain settings. Owners and admins manage organization secrets.

Your sessions receive secrets and variables as environment variables when they start.

  • Secrets are encrypted at rest and masked in the terminal output, for API keys, tokens and passwords.
  • Variables are plain settings, such as NODE_ENV, and are visible in output.

They come at three levels. When two have the same name, the more specific one wins:

LevelWhere you set itWho it applies to
OrganizationSecrets in the sidebarAll AI Teams, or the teams you select
AI TeamThe team's Secrets and Variables tabsThat team's sessions
PersonalYour profile, Secrets and variablesOnly the sessions you own

Claude itself signs in with claude login inside the session. Your Claude account is never stored as a secret.

The organization Secrets page with the Secrets and Variables tabs, a search field, a scope filter, Import .env and Add, and three secrets: ANALYTICS_API_KEY, SENTRY_DSN and WAREHOUSE_PASSWORD.The organization Secrets page with the Secrets and Variables tabs, a search field, a scope filter, Import .env and Add, and three secrets: ANALYTICS_API_KEY, SENTRY_DSN and WAREHOUSE_PASSWORD.

Add an organization secret

  1. Open Secrets

    Select Secrets in the sidebar, then Add.

  2. Name it and paste the value

    Keep Secret selected. Use the name your code expects, such as SLACK_WEBHOOK_URL, and paste the value.

  3. Choose the scope

    All AI Teams, or Selected AI Teams and pick them. Select Add secret.

    The Add secret dialog with the Secret and Variable types, the name SLACK_WEBHOOK_URL, the value field and the All AI Teams and Selected AI Teams scopes.The Add secret dialog with the Secret and Variable types, the name SLACK_WEBHOOK_URL, the value field and the All AI Teams and Selected AI Teams scopes.

A change applies the next time a session starts. To add many at once, select Import .env and choose a .env file.

Variables

Open the Variables tab and select Add, or choose Variable in the same dialog. Variables are visible in output, so never put a secret in one.

The Variables tab listing APP_REGION with the value us-east and NODE_ENV with the value production, both for all AI Teams.The Variables tab listing APP_REGION with the value us-east and NODE_ENV with the value production, both for all AI Teams.

Team secrets

Open an AI Team and its Secrets tab to add secrets only that team gets. Its Variables tab also shows the organization variables the team receives.

See a secret's value

Select the eye next to a secret to reveal it, then Copy. Revealing a value is recorded in the audit log as "Revealed a secret".

Who can do this

Organization owners and admins see, add and reveal organization secrets. Team owners manage their team's secrets. Everyone in the organization can see and change organization variables.