edit_goal_update
Edit a previously-posted goal update by its ID to fix typos, adjust status/score, correct metric values, or replace the More detail body. Only the fields you provide are changed.
Instructions
Edit a previously-posted goal update — fix a typo, adjust status/score, correct a metric value, replace the More detail body, etc. Identify the update by its ARI (the id returned from post_goal_update or from a goal's updates list). Both goalId and goalUpdateId are required so the tool can resolve the existing note ARI when replacing details.
Only the fields you supply are changed; all others are left alone. At least one of summary/details/status/score/targetDate/metricUpdates is required.
Status/score behaves identically to post_goal_update: on_track/at_risk/off_track derive from a 1–100 score; pending/paused/done/cancelled/archived take only status.
Markdown — both summary and details accept markdown and are converted to ADF before send.
Details replace, not append — when details is supplied, the tool looks up the update's existing "More detail" note and overwrites it. (Townsquare's editUpdate API would otherwise create a second note that the UI doesn't surface.)
Metric updates — edit_goal_update takes metricId (the metric itself), not targetId (the metric target). This is asymmetric with post_goal_update and matches the Townsquare API.
Example
edit_goal_update({
goalId: "ari:cloud:townsquare:...:goal/abc",
goalUpdateId: "ari:cloud:townsquare:...:goal-update/xyz",
summary: "Corrected summary — actually on track, not at risk.",
status: "on_track"
})Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| score | No | Confidence score on the 1–100 scale. | |
| dryRun | No | If true, return the resolved mutation payload without submitting | |
| goalId | Yes | Goal ARI that owns the update (format: ari:cloud:townsquare:{cloudId}:goal/{uuid}). Required so the tool can look up the existing More-detail note when replacing details. | |
| status | No | Status — same score/non-score rules as post_goal_update. | |
| details | No | New "More detail" body (markdown supported). Behavior with existing notes is currently to append a new note; verify if replacement is needed. | |
| summary | No | New headline (max 280 chars, markdown supported) | |
| targetDate | No | New target date | |
| goalUpdateId | Yes | Goal update ARI (format: ari:cloud:townsquare:{cloudId}:goal-update/{uuid}) | |
| metricUpdates | No | New current values. Each item uses metricId (NOT targetId — this differs from post_goal_update). |