Object relations allow you to define relationships between objects in monday.com, such as dependencies or aliases between boards and dashboards.

🚧
Only available in API versions 2026-04 and later

Queries

object_relations

Fetch relations for an object.

Returns [ObjectRelation!]

Arguments

Argument	Type	Description
object_id	`ID!`	The unique identifier of the object whose relations to return.
kind	`RelationKind`	Optional. Filter by relation kind: `ALIAS` or `DEPENDENCY`.
direction	`RelationDirection`	Optional. `OUTGOING` or `INCOMING`. Default: `OUTGOING`.

Example

query {
  object_relations(
    object_id: "1234567890"
    direction: OUTGOING
    kind: DEPENDENCY
  ) {
    id
    source_object_id
    target_id
    target_object_type
    kind
  }
}

Fields on ObjectRelation

Field	Type	Description
id	`ID`	The relation’s unique identifier.
source_object_id	`ID`	The object the relation starts from.
target_id	`ID`	The related object’s unique identifier.
target_object_type	`TargetObject`	The type of the target: `BOARD` or `DASHBOARD`.
kind	`RelationKind`	The relation kind as a lowercase string (for example, `"dependency"`).

Mutations

create_object_relations

Create relations between objects.

Returns [ObjectRelation!]

Arguments

Argument	Type	Description
source_object_id	`ID!`	The object to attach relations from.
relations	`[ObjectRelationInput!]!`	One or more relations to create.

Example

mutation {
  create_object_relations(
    source_object_id: "1234567890"
    relations: [{
      kind: DEPENDENCY
      target_id: "9876543210"
      target_object_type: BOARD
    }]
  ) {
    id
    source_object_id
    target_id
    target_object_type
    kind
  }
}

delete_object_relation

Delete relation(s). Returns an Int: the number of relations deleted.

Arguments

Argument	Type	Description
source_object_id	`ID!`	The object whose relations are being deleted.
relation_id	`ID`	Optional. The specific relation to delete. Omit to delete all relations for the source object.

Example

mutation {
  delete_object_relation(
    source_object_id: "1234567890"
    relation_id: "27"
  )
}