Ligantic
Docs
Tutorials
How-to guides
Reference
Explanation
Login
Free Sign Up
Docs
/
Reference
/
Flows
/
Node types
/
Data

Data - Context

Type identifier: data:context Category: Data Operations

Description

Provides access to run context values. Use this node to retrieve metadata about the current run, such as the Space ID, run ID, or the identity of the user who triggered the Flow.

Input Handles

This node has no input handles. It provides context values from the run environment.

Output Handles

Handle

Data Type

Description

value

string or date

The requested context value

Output Handle Details

value

  • Type:

    • string for spaceId, flowExecutionId, spaceIdentityId
    • date for createdAt, startedAt
  • Notes: Data type depends on the selected valueId

Configuration Options

Property

Type

Required

Default

Description

label

string

Yes

"Data - Context"

Display label for the node

valueId

string

Yes

"spaceIdentityId"

Which context value to output

Configuration Details

valueId

  • Type: "spaceId" | "flowExecutionId" | "spaceIdentityId" | "createdAt" | "startedAt"

Available Values:

Value

Output Type

Description

spaceId

string

CUID2 identifier of the current Space

flowExecutionId

string

CUID2 identifier of the current run

spaceIdentityId

string

CUID2 identifier of the user/identity who triggered the Flow

createdAt

date

ISO 8601 timestamp when the run was created

startedAt

date

ISO 8601 timestamp when the run started

Behaviour

Execution Flow

  1. When the node is processed, it reads the requested context value
  2. The value is set as output on the value handle
  3. Date values are converted to ISO 8601 JSON string format

Context Values

  • spaceId: The Space in which the Flow is running
  • flowExecutionId: Unique identifier for this specific run
  • spaceIdentityId: The identity that triggered the Flow (user or API client)
  • createdAt: When the run record was created (before any processing)
  • startedAt: When the run actually began processing

Edge Cases

Scenario

Behaviour

Unknown valueId

Error: "Unknown valueId: ..."

No identity context

spaceIdentityId may be null/empty

Examples

Get Space ID

{
  "type": "data:context",
  "data": {
    "label": "Get Space ID",
    "valueId": "spaceId"
  }
}

Output Handles:

  • value (string) — labelled "Space Id"

Get Space Identity ID

{
  "type": "data:context",
  "data": {
    "label": "Get User ID",
    "valueId": "spaceIdentityId"
  }
}

Output Handles:

  • value (string) — labelled "Space Identity Id"

Get Run Start Time

{
  "type": "data:context",
  "data": {
    "label": "Get Start Time",
    "valueId": "startedAt"
  }
}

Output Handles:

  • value (date) — labelled "Started At"

Usage Pattern - Personalized Response

[data:context (spaceIdentityId)] → [object:query (User)] → [object:pick (name)] → [text:template ("Hello, {name}!")]

Related pages

Data - Expression
Evaluates a mathematical or logical expression with variables. Supports arithmetic, string manipulation, date/time operations, similarity functions, and array operations. Use this node for calculations, transformations, and complex data logic.
Data - Literal
Provides a static data value of any supported type. Use this node to inject constant values into your Flow, such as configuration strings, default numbers, or structured objects.
Flow - Trigger
Entry point for Flow runs. Defines the inputs that a Flow accepts and makes them available to downstream nodes. Every Flow must have exactly one trigger node.