update_goal

Beschreibung

Ändert genau ein Ziel der verbundenen Organisation: Phase, Konfidenz (0–100), Titel, Beschreibung, Reflexion und/oder Owner (ownerId: ein Mitglied der Organisation, das dem Ziel dann automatisch folgt; null entfernt den Owner; ein Nicht-Mitglied ergibt { error: "invalid_field", field: "ownerId", reason }) — geschrieben wird nur, was Du übergibst, im Namen des verbundenen Nutzers und mit Eintrag in der Änderungshistorie des Ziels. Eine reine Phasenänderung setzt das Ziel wie beim Ziehen auf dem Board ans Ende der neuen Spalte. Ändert sich die Phase, enthält die Antwort zusätzlich den Stand des Qualitäts-Gates (qualityGate) wie auf dem Board — nur zur Anzeige: Ein rotes Gate blockiert keinen Wechsel. Für Lesen-Ändern-Schreiben übergibst Du das updatedAt aus get_goal als expectedUpdatedAt: Hat sich das Ziel inzwischen geändert, wird nichts geschrieben und Du bekommst { error: "conflict", currentUpdatedAt }. 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:

Change ONE goal in the connected organization: its stage, confidence (0–100), title, description, reflection and/or owner — only the fields you pass are written, as the connected user, and each change lands in the goal’s changelog. A stage-only change moves the goal to the end of the new stage’s column, like a board drag. ownerId is the user id of an org member (from get_org_context), or null to remove the owner; a new owner automatically follows the goal. When the stage changed, the result also carries qualityGate — the stage-gate status the board shows: { enabled: false } when the gate is off for this organization, { enabled: true, gated: false } for a stage it does not assess, else { enabled: true, gated: true, marker, pending } where marker is null (no marker) or { status: “gelb”|“rot”, notMet, evaluated } and pending means the latest changes are not assessed yet. The gate is display only: a red gate never blocks a move. For a read-modify-write, pass the updatedAt you read from get_goal as expectedUpdatedAt: if the goal changed since, nothing is written and the result is an error { error: “conflict”, currentUpdatedAt } — re-read with get_goal and retry deliberately rather than blindly. Other errors: { error: “not_found” } (no such goal in this organization), { error: “no_fields” } (nothing to change), { error: “invalid_title” } (blank after collapsing whitespace), { error: “invalid_field”, field: “ownerId”, reason } (not a member of this organization; nothing was written), { error: “graph_unavailable”, retryable: true } — a title or owner change is rolled back, but other fields sent with it may already be saved, so re-read with get_goal before retrying. On success returns the updated goal, including its new updatedAt. Only available on connections granted write access.

Parameter

Name	Typ	Pflicht	Einschränkungen	Beschreibung
goalId	Text	Ja		The goal id
stage	Text	Nein	ideation | scoped | rated | next | wip | blocked | reflect | done | declined	Move the goal to this pipeline stage
confidence	Ganzzahl	Nein	0–100	New confidence, an integer 0–100
title	Text	Nein		New title (collapsed to one line)
description	Text	Nein		New description (replaces the old one)
reflection	Text	Nein		New reflection — what was learned (replaces the old one)
ownerId	Text oder null	Nein		User id of an org member to own the goal (from get_org_context); null to clear
expectedUpdatedAt	Text	Nein		The updatedAt you last read from get_goal. When given, the write is refused with { error: “conflict” } if the goal changed since.

Zurück zur Übersicht