Object - Query Link
Type identifier:
object:queryLinkCategory: Object Operations
Description
Queries relationships between Records to find linked Records. Given either a source Record or target Record, finds the corresponding linked Record via a specific relationship type. Returns Record IDs for further processing.
Input Handles
Handle | Data Type | Required | Description |
|---|---|---|---|
|
| No | Source Record ID for forward lookup |
|
| No | Target Record ID for reverse lookup |
Input Handle Details
from
- Type:
string(CUID2) Notes:
- When provided, finds the linked
toId - Used for forward relationship traversal
- If null or non-string, returns
nullfortoId
- When provided, finds the linked
to
- Type:
string(CUID2) Notes:
- When provided, finds the linked
fromId - Used for target-side relationship traversal
- If null or non-string, returns
nullforfromId
- When provided, finds the linked
Output Handles
Handle | Data Type | Description |
|---|---|---|
|
| Source Record ID from reverse lookup |
|
| Target Record ID from forward lookup |
Output Handle Details
fromId
- Type:
stringornull Notes:
- Populated when
toinput is provided - Returns first matching source Record ID
- Returns
nullif no relationship found
- Populated when
toId
- Type:
stringornull Notes:
- Populated when
frominput is provided - Returns first matching target Record ID
- Returns
nullif no relationship found
- Populated when
Configuration Options
Property | Type | Required | Default | Description |
|---|---|---|---|---|
|
| Yes |
| Display label for the node |
|
| Yes |
| Schema ID (for filtering) |
|
| Yes |
| CUID2 of the relationship version |
Configuration Details
relationshipVersionId
- Type:
string(CUID2) Notes:
- References a Schema relationship version
- Determines the relationship type to query
- Must be a valid relationship in the Space
Behaviour
Execution Flow
For fromId output (reverse lookup):
- Resolves
toinput handle - Validates input is a string
- Finds the source Record of the relationship in the current Space
- Returns first matching source Record ID or
null
For toId output (forward lookup):
- Resolves
frominput handle - Validates input is a string
- Finds the target Record of the relationship in the current Space
- Returns first matching target Record ID or
null
Matching Rules
A relationship matches only when:
- Relationship version matches
- Relationship is not removed
- Both source and target Schemas are in the current Space
- Schema versions are not removed
Result Handling
Scenario | Behaviour |
|---|---|
Input is null | Returns |
Input is not a string | Returns |
No relationship found | Returns |
Multiple relationships | Returns first match |
Examples
Forward Lookup (From → To)
{
"type": "object:queryLink",
"data": {
"label": "Get Customer for Order",
"schemaId": "order-schema-uuid",
"relationshipVersionId": "order-customer-rel-uuid"
}
}Given an order ID in from input, returns the customer ID in toId output.
Reverse Lookup (To → From)
{
"type": "object:queryLink",
"data": {
"label": "Get Orders for Customer",
"schemaId": "order-schema-uuid",
"relationshipVersionId": "order-customer-rel-uuid"
}
}Given a customer ID in to input, returns an order ID in fromId output.
Chained Relationship Query
{
"type": "object:queryLink",
"data": {
"label": "Find Parent Category",
"schemaId": "category-schema-uuid",
"relationshipVersionId": "category-parent-rel-uuid"
}
}Chaining multiple Object - Query Link nodes navigates hierarchical relationships.