Dokumentacja dla programistów
Relacje między obiektami
Dokumentacja API (rdzeń)Dokumentacja API
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.
- Zwraca
[ObjectRelation!]
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.
- Zwraca
[ObjectRelation!]
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"
)
}