create_goal

Beschreibung

Legt genau ein neues Ziel in der verbundenen Organisation an, im Namen des verbundenen Nutzers: Es landet in der Phase Ideation am Ende der Spalte und bekommt einen Eintrag „erstellt“ in seiner Änderungshistorie. Du übergibst einen Titel, optional eine Beschreibung, optional einen Owner (ownerId, ein Mitglied der Organisation — er folgt dem Ziel dann automatisch) und optional den eigenen geplanten Aufwand des Nutzers (S–XXL) — er zählt genau wie eine Aufwandsschätzung über set_effort_vote und wird zum Aufwand des Ziels, wenn der Nutzer selbst Owner ist. Ein Owner, der kein Mitglied ist, ergibt { error: "invalid_field", field: "ownerId", reason }. Zurück kommt das neue Ziel mit id und updatedAt. 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:

Create ONE goal in the connected organization, as the connected user: it lands in the ideation stage at the end of the column, with a “created” entry in its changelog. Pass a title (collapsed to one line), optionally a description, optionally ownerId — the user id of an org member (from get_org_context) who then owns and follows the goal; omit it for a goal without owner — and optionally effort — the connected user’s OWN planned estimate on the scale S < M < L < XL < XXL, recorded exactly like set_effort_vote with phase “planned”. That estimate becomes the goal’s owner-planned effort field only when ownerId is the connected user. Search with search_goals first so you do not create a duplicate. Returns the new goal including its id and updatedAt. Errors: { error: “invalid_title” } (blank after collapsing whitespace), { error: “invalid_field”, field: “ownerId”, reason } (not a member of this organization; nothing was created), { error: “graph_unavailable”, retryable: true } (nothing was created; retry). Only available on connections granted write access.

Parameter

Name	Typ	Pflicht	Einschränkungen	Beschreibung
title	Text	Ja		The goal title (collapsed to one line)
description	Text	Nein		The goal description
effort	Text	Nein	S | M | L | XL | XXL	Your own planned effort estimate (t-shirt size, Fibonacci scale)
ownerId	Text	Nein		User id of an org member to own the goal (from get_org_context)

Zurück zur Übersicht