Secret - Get
Type identifier:
secret:getCategory: Secret Operations
Description
The Secret - Get node retrieves a secret value from the secure secret store. Secrets are stored encrypted and are only decrypted when needed. The retrieved value is returned as a wrapped secret that can be passed to other nodes requiring credentials.
Input Handles
Handle | Type | Description |
|---|---|---|
|
| (Dynamic) Path to the secret in the store. |
Note: The path handle appears when set to dynamic mode.
Output Handles
Handle | Type | Description |
|---|---|---|
| secret (wrapped) | The retrieved secret value (wrapped). |
Configuration Options
Option | Type | Default | Description |
|---|---|---|---|
Path |
|
| Path to the secret in the store. |
Secret Selection
The node shows a Secret picker for secrets in the current Space. You can select an existing secret or create one from the picker.
New nodes start with no secret selected and Advanced off.
The unselected default is not a valid execution path. Select a secret or enter a complete path before running the Flow. Empty path segments are rejected without contacting the secret store; this applies in both picker and Advanced modes.
Enable Advanced to edit the path segments directly or enable Dynamic? to supply the path through an input handle. Advanced mode opens automatically when a configured path is not in the list of secrets. Dynamic paths and organisation-scoped secrets always use Advanced mode.
Turning Dynamic? off leaves Advanced enabled so you can enter a literal path. Use the Advanced switch to return to the secret picker.
Switching between the picker and Advanced mode does not change the stored path or secret source.
Path Structure
Paths are arrays of strings representing a hierarchical key:
["api-key"]— Top-level secret["integrations", "stripe", "secret-key"]— Nested path
Behaviour
- Resolves the secret path
- Looks up the secret
- Returns the secret value as a wrapped secret object
- Wrapped secrets can be passed to nodes that accept credentials
Wrapped Secrets
In Flows v2, the value output has the Sensitive trait. Its handle badge opens a source-declaration overlay on hover or keyboard focus. Run inspection shows the observed trait without revealing the wrapped payload. Flow Result cannot return this value or an object containing a sensitive field.
Secrets are returned in a wrapped format:
- The actual value is not exposed in logs or outputs
- Other nodes can unwrap secrets when needed
- Provides defence against accidental exposure
Security
- Secrets are stored encrypted at rest
- Access is scoped to the Space or identity
- Run log tracks secret access
Examples
Retrieve API Key
Configuration:
- Path:
["api-keys", "openai"]
Output: Wrapped secret containing the API key.
Dynamic Secret Path
Configuration:
- Path: dynamic
Input:
path:["customers", customerId, "api-key"]
Use case: Retrieve customer-specific credentials.