update_goal
Edit a goal's name, description, owner, dates, or archive status. Only supplied fields change; status and tags remain unaffected.
Instructions
Edit a goal's metadata — name, description, owner, target date, start date, or archive flag. Status changes are NOT done here; use post_goal_update to change status. Tag changes are also separate (use add_goal_tags / remove_goal_tags).
Only the fields you supply are changed; all others are left alone. At least one editable field is required.
Markdown — description accepts markdown and is converted to ADF before send.
Owner — pass an Atlassian account ID (the same value that comes back from get_goal as owner.accountId).
Archive — archived: true archives the goal (hides it from active lists); archived: false unarchives. This is destructive in effect — confirm with the user before archiving real goals.
Example
update_goal({
goalId: "ari:cloud:townsquare:...:goal/abc",
name: "Renamed goal",
description: "## New description\nUpdated context here.",
targetDate: { date: "2026-12-31", confidence: "QUARTER" }
})Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | New goal name (plain text) | |
| dryRun | No | If true, return the resolved mutation payload without submitting | |
| goalId | Yes | Goal ARI (format: ari:cloud:townsquare:{cloudId}:goal/{uuid}) | |
| ownerId | No | New owner — pass an Atlassian account ID (e.g. "712020:user-uuid-here") | |
| archived | No | Set true to archive the goal, false to unarchive. Destructive in effect — confirm before archiving. | |
| startDate | No | New start date (YYYY-MM-DD) | |
| targetDate | No | New target date | |
| description | No | New goal description (markdown supported, converted to ADF) |