ideas_update
Destructive
Update a discovery idea. tagIds replaces all tags (use expectedTagIds to protect against stale edits); addTagIds/removeTagIds change only the named tags. Address the idea by its internal UUID or human-readable publicId in the authenticated workspace. Set projectId to an Initiative UUID/publicId to attach the idea, or null to detach it. Classification assignments patch only the supplied taxonomy groups and the result echoes persisted values for verification.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>"
},
"name": "ideas_update"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Internal UUID or the human-readable publicId, e.g. "IDEA-14". | |
| name | No | A short name for the idea in the team's words, as they would say it in a meeting. | |
| effort | No | ||
| status | No | ||
| tagIds | No | Existing workspace tag IDs to attach. Use tags.create first when a tag does not exist. | |
| addTagIds | No | Add existing workspace tags without removing other tags. Safe to retry. | |
| productId | No | ||
| projectId | No | Initiative UUID/publicId to attach this idea to, or null to detach it. | |
| sourceKey | No | Stable source namespace used with externalId for idempotent upserts. | |
| accountIds | No | ||
| assigneeId | No | ||
| externalId | No | ||
| insightIds | No | ||
| userImpact | No | ||
| description | No | What the idea is, written the way the team would write it themselves: one to three short paragraphs of plain sentences (Markdown is fine, no HTML) on who has the problem, what changes for them, and why it matters, in the team's own words. Leave out memo labels such as "Who and decision:", "Proposal:" or "Boundary:", notes on how or by whom the record was made, and caveats about what is not yet validated; the idea's status and readiness already say that. Link supporting evidence with insightIds rather than quoting it here. | |
| globalScore | No | ||
| removeTagIds | No | Remove only these tags; preserve all other tags. Safe to retry. | |
| externalLinks | No | ||
| integrationId | No | ||
| expectedTagIds | No | For tagIds replacement, pass the tag IDs last read to reject stale edits. Prefer addTagIds/removeTagIds for individual changes. | |
| opportunityIds | No | ||
| affectedMetrics | No | ||
| classifications | No | Patch-style assignments for workspace taxonomy groups. Omitted groups remain unchanged. | |
| validateInsightLinks | No | Set true only when the supplied insightIds are an intentionally confirmed evidence path. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| item | Yes |