Object - Link
Type identifier:
object:linkCategory: Object Operations
Description
Links a source Record (from) to a target Record (to) using a configured relationship version. Depending on relationship cardinality, the operation creates a relationship, repoints an existing relationship, or leaves an exact active relationship unchanged.
Input Handles
Handle | Data Type | Connection required | Description |
|---|---|---|---|
|
| No | Activates the link operation |
|
| No | Source Record ID or object with |
|
| No | Target Record ID or object with |
Input Handle Details
from
- Type:
string(CUID2) or object withidproperty Notes:
- Accepts a Record ID directly
- Accepts a Record object (extracts
idproperty) - Must contain a CUID2 ID; otherwise the node emits
error
to
- Type:
string(CUID2) or object withidproperty Notes:
- Same behaviour as
from - Target Record for the relationship
- Same behaviour as
Output Handles
Handle | Data Type | Description |
|---|---|---|
|
| Triggered when the relationship is created, updated, or unchanged |
|
| Triggered for invalid endpoints and expected domain errors |
Configuration Options
Property | Type | Required | Default | Description |
|---|---|---|---|---|
|
| Yes |
| Display label for the node |
|
| Yes |
| Retained node configuration; not used by this node |
|
| Yes |
| CUID2 of the relationship version |
Configuration Details
relationshipVersionId
- Type:
string(CUID2) Notes:
- References a Schema relationship version
- Determines the relationship type and direction
- Configured via relationship dropdown in UI
Behaviour
Execution Flow
- Resolves connected
fromandtoinputs. - Extracts each ID from a CUID2 string or an object with its own
idproperty. - Routes missing or invalid IDs to
error. - Creates or updates the relationship using
relationshipVersionIdand the run identity. - Emits
successforcreated,updated, andunchangedactions.
Relationship Actions
Action | Behaviour |
|---|---|
| Creates a new relationship. |
| Repoints the existing cardinality-conflicting relationship's endpoint. |
| Leaves an exact active relationship unchanged. |
When cardinality controls are unavailable or disabled, link requests create new relationships rather than repointing existing ones. The node has no data output.
Error Handling
Scenario | Behaviour |
|---|---|
| Triggers |
Expected relationship/domain rejection | Triggers |
Examples
Link Records by ID
{
"type": "object:link",
"data": {
"label": "Link Order to Customer",
"schemaId": "order-schema-uuid",
"relationshipVersionId": "order-customer-rel-uuid"
}
}Connects from input (order ID) to to input (customer ID).
Link From Query Results
{
"type": "object:link",
"data": {
"label": "Assign Task to User",
"schemaId": "task-schema-uuid",
"relationshipVersionId": "task-assignee-rel-uuid"
}
}Can receive full Record objects from Object - Query nodes; automatically extracts IDs.