Login
Free Sign Up
Docs
/

Secret - Get

Type identifier: secret:get Category: 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

path

string[]

(Dynamic) Path to the secret in the store.

Note: The path handle appears when set to dynamic mode.

Output Handles

Handle

Type

Description

value

secret (wrapped)

The retrieved secret value (wrapped).

Configuration Options

Option

Type

Default

Description

Path

string[] or dynamic

["my-secret"]

Path to the secret in the store.

Path Structure

Paths are arrays of strings representing a hierarchical key:

  • ["api-key"] — Top-level secret
  • ["integrations", "stripe", "secret-key"] — Nested path

Behaviour

  1. Resolves the secret path
  2. Looks up the secret
  3. Returns the secret value as a wrapped secret object
  4. Wrapped secrets can be passed to nodes that accept credentials

Wrapped Secrets

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.

Related pages