write_resource
Persist validated edits to existing tasks or epics by replacing, inserting, or appending content, then reconcile indexes and diagnostics.
Instructions
Use when you want backlog-mcp to validate and canonically persist an existing entity edit before reporting success. For ordinary repository prose edits, use your native Edit tool; reconciliation updates indexes and diagnostics afterward. Create and transition entities through the substrate-declared intent tools.
The
appendcommand will add content to the end of the body, automatically adding a newline if needed. Notes for using thestr_replacecommand:The
old_strparameter should match EXACTLY one or more consecutive lines from the original body. Be mindful of whitespaces!If the
old_strparameter is not unique in the body, the replacement will not be performed. Include enough context to make it unique.The
new_strparameter should contain the edited lines that should replace theold_str
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| as | No | OPTIONAL agent identity for this write — an AGENT- doc id or declared principal (e.g. "aime:granite"). Values are trimmed; whitespace-only is treated as absent. | |
| id | Yes | Task or epic ID, e.g. TASK-0001 or EPIC-0002 | |
| home | No | Select the document home for this call. Overrides bridge defaults: global uses the user-wide home; project uses project_root or the bridge project. | |
| operation | Yes | Operation to apply to the body | |
| project_root | No | Project root for this call. Overrides the bridge project root and selects the project home. |