create_comment

Beschreibung

Schreibt genau einen Kommentar an ein Ziel oder eine Aufgabe, im Namen des verbundenen Nutzers — in der App erscheint er mit „via Agent” (bzw. „via CLI”) und lässt sich dort wie jeder eigene Kommentar bearbeiten oder löschen. Kommentieren darf, wer den Gegenstand sehen darf; die persönliche Aufgabe eines anderen liefert { error: "not_found" }. Der Text ist reiner Text: Markdown oder HTML wird nicht interpretiert, jede Zeile wird ein Absatz. Erwähnungen schreibst Du als @{userId} an die gewünschte Stelle; IDs in mentions ohne Token werden ans Ende gehängt. Erwähnungen von Nicht-Mitgliedern oder Dir selbst werden verworfen, nie als Fehler — die Antwort nennt applied und dropped. Erwähnte bekommen Benachrichtigung und E-Mail, Follower werden wie in der App benachrichtigt. Zu langer Text (über 5000 Zeichen) liefert { error: "invalid_field", field: "text", reason }. Nur verfügbar mit Schreibzugriff (goals:write), für die Organisation freigeschaltetem Schreiben und aktivierten Kommentaren.

Beschreibung für das Modell

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

Post ONE comment on a goal or task in the connected organization, as the connected user — it appears in the app marked “via Agent” (or “via CLI”), and the user can edit or delete it there. Anyone who can see the subject may comment. text is PLAIN text: no Markdown or HTML is interpreted (it is shown literally); each line becomes a paragraph. To mention a colleague write @{userId} where the mention should appear (user ids from get_org_context); ids in mentions without a token are appended at the end. A mention of anyone who is not an org member — or yourself — is dropped, never an error. Mentioned colleagues get a notification and an email, and the subject’s followers are notified, exactly as for a comment written in the app. Align with the user on the exact wording before posting. Errors: { error: “invalid_field”, field: “text”, reason } (empty, or longer than 5000 characters with mentions counted as @Name), { error: “not_found” } (no such subject you can see — including another user’s personal task). On success returns the comment and mentions { applied, dropped } (user ids). Only available on connections granted write access, in organizations that use comments.

Parameter

Name	Typ	Pflicht	Einschränkungen	Beschreibung
subjectType	Text	Ja	goal | task	The subject kind to comment on
subjectId	Text	Ja		The goal id or task id
text	Text	Ja		Plain text (no Markdown/HTML); newlines start paragraphs. Write @{userId} where a mention should appear
mentions	Liste	Nein		User ids to mention; any without an @{userId} token in text are appended at the end

Zurück zur Übersicht