post_goal_update
Post a goal status update with summary, status, score, metric values, and target date. Resolve goal ARI first to keep progress visible in the goal's Updates tab.
Instructions
Post a weekly status update to a goal — the entry that appears in the goal's Updates tab. Resolve the goal's ARI via search_goals or get_goal first; this tool requires the ID, not a name.
Status and score Status for on_track / at_risk / off_track is derived from the score (1–100 integer). Pick whichever the user expresses:
"we're on track" →
status: "on_track"(tool fills the band's midpoint score, 80)"on track at 90" →
status: "on_track", score: 90"score 50" alone →
score: 50(status inferred as at_risk) The Atlassian UI labels these as decimals (e.g. "On track - 0.8"), but the API stores them as 1–100. Translate accordingly: 0.8 → 80. For pending / paused / done / cancelled / archived, send onlystatus— these are non-score states and adding a score is a validation error.
Markdown
Both summary and details accept markdown — headings, bold/italic, lists, links, inline and block code, blockquotes. The tool converts to ADF before sending.
Example call
post_goal_update({
goalId: "ari:cloud:townsquare:...:goal/abc",
summary: "Shipped the migration; on track for end-of-quarter delivery.",
details: "## What landed\n- Migration scripts merged\n- Rollback plan validated",
status: "on_track",
metricUpdates: [{ targetId: "...", value: 42 }]
})Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| score | No | Confidence score on the 1–100 scale (the Atlassian UI labels these as decimals like "0.8" but the API stores integers). Bands: 10–30 = off_track, 40–60 = at_risk, 70–100 = on_track. If status is omitted, it is inferred from the band. | |
| dryRun | No | If true, return the resolved mutation payload without submitting | |
| goalId | Yes | Goal ARI (format: ari:cloud:townsquare:{cloudId}:goal/{uuid}). Obtain from search_goals or get_goal. | |
| status | No | Reported status. Score-driven (on_track/at_risk/off_track) — supplied alone, uses band midpoint score (80/50/20). Combined with score, validates that score falls within the band. Non-score (pending/paused/done/cancelled/archived) — must NOT be combined with score. | |
| details | No | Optional longer-form content for the "More detail" panel. Markdown supported (headings, bold/italic, lists, links, code, blockquotes). No length limit. | |
| summary | Yes | Update headline shown by default in the Updates tab. Max 280 characters. Markdown supported. | |
| targetDate | No | Optionally update the target date as part of this status post | |
| metricUpdates | No | Current values to record against the goal's metric targets |