Dokumentacja dla programistów

Relacje między obiektami

Aktualizacja 2026-09-06

Relacje między obiektami pozwalają definiować powiązania między obiektami w monday.com, takie jak zależności lub aliasy między tablicami i pulpitami.

Dostępne tylko w wersjach API 2026-04 i nowszych


Zapytania

object_relations

Pobiera relacje obiektu.

Argumenty

Argument Typ Opis
object_id ID! Unikalny identyfikator obiektu, którego relacje mają zostać zwrócone.
kind RelationKind Opcjonalnie. Filtruje według rodzaju relacji: ALIAS lub DEPENDENCY.
direction RelationDirection Opcjonalnie. OUTGOING lub INCOMING. Domyślnie: OUTGOING.

Przykład

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

Pola ObjectRelation

Pole Typ Opis
id ID Unikalny identyfikator relacji.
source_object_id ID Obiekt, od którego zaczyna się relacja.
target_id ID Unikalny identyfikator powiązanego obiektu.
target_object_type TargetObject Typ obiektu docelowego: BOARD lub DASHBOARD.
kind RelationKind Rodzaj relacji zapisany małymi literami (na przykład "dependency").

Mutacje

create_object_relations

Tworzy relacje między obiektami.

Argumenty

Argument Typ Opis
source_object_id ID! Obiekt, z którego mają zostać utworzone relacje.
relations [ObjectRelationInput!]! Jedna lub więcej relacji do utworzenia.

Przykład

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

Usuwa relację lub relacje. Zwraca wartość Int: liczbę usuniętych relacji.

Argumenty

Argument Typ Opis
source_object_id ID! Obiekt, którego relacje są usuwane.
relation_id ID Opcjonalnie. Konkretna relacja do usunięcia. Pomiń ten argument, aby usunąć wszystkie relacje obiektu źródłowego.

Przykład

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