add_goal_dependency

Beschreibung

Verknüpft ein Ziel mit einem anderen Ziel derselben Organisation: DEPENDS_ON heißt, goalId braucht zuerst targetGoalId; CONTRIBUTES_TO heißt, goalId zahlt auf targetGoalId ein. Eine bereits bestehende Verknüpfung bleibt unverändert (created: false). Verknüpfungen eines Ziels mit sich selbst (invalid_target) und Verknüpfungen, die über Kanten desselben Typs einen Kreis schließen würden (cycle), werden abgelehnt. Wie in der App entsteht kein Eintrag in der Änderungshistorie. Nur verfügbar, wenn die Verbindung Schreibzugriff (goals:write) erhalten hat UND Schreibzugriff für die Organisation freigeschaltet ist — sonst taucht das Werkzeug gar nicht erst auf.

Beschreibung für das Modell

Diesen Text sieht das KI-Modell — unverändert und auf Englisch, so wie ihn der Server ausliefert:

Link ONE goal to another goal in the connected organization: type DEPENDS_ON means goalId needs targetGoalId done first; CONTRIBUTES_TO means goalId helps achieve targetGoalId. The edge points from goalId to targetGoalId and shows in get_goal as an outgoing dependency of goalId and an incoming one of targetGoalId. Adding an edge that already exists is a no-op (created: false). Unlike other writes it leaves no changelog entry, exactly like a link added in the app. Errors: { error: “not_found”, field: “goalId” | “targetGoalId” } (not in this organization), { error: “invalid_target” } (goalId equals targetGoalId), { error: “cycle” } (targetGoalId already reaches goalId through edges of the same type — the link would close a loop), { error: “graph_unavailable”, retryable: true } (nothing was written). On success returns { dependency: { goalId, targetGoalId, type, created } }. Only available on connections granted write access.

Parameter

Name	Typ	Pflicht	Einschränkungen	Beschreibung
goalId	Text	Ja		The goal the edge starts from — the one that depends on / contributes to the other
targetGoalId	Text	Ja		The goal it depends on (DEPENDS_ON) or contributes to (CONTRIBUTES_TO)
type	Text	Ja	DEPENDS_ON | CONTRIBUTES_TO	DEPENDS_ON = goalId needs targetGoalId done first; CONTRIBUTES_TO = goalId helps achieve targetGoalId

Zurück zur Übersicht