update_spec_task
writeFeature Specs
Update a task's status or content (single or batch status updates).
Connected surface
This tool and the Specs dashboard page are two surfaces over the same data. The dashboard is where you view and curate it;
update_spec_task is how your AI can mark tasks in progress and complete as the work actually happens. How surfaces connect →Write tool
Mutates Rampify state, triggers background work, or calls a paid external API. Most clients ask for confirmation before invoking.
Parameters
| Parameter | Type | Description | |
|---|---|---|---|
| spec_id | string | optional | Spec UUID (resolved from task_id if omitted) |
| task_id | string | optional | Task UUID for single update |
| status | enum("todo" | "in_progress" | "completed" | "blocked") | optional | New task status |
| title | string | optional | New task title (single mode) |
| description | string | optional | New task description (single mode) |
| task_type | enum("backend" | "frontend" | "database" | "testing" | "docs") | optional | Category of work (single mode) |
| files_to_modify | string[] | optional | Files this task is expected to change (single mode) |
| code_snippet | string | optional | Reference code snippet for the task (single mode) |
| tasks | object[] | optional | Batch mode: multiple {task_id, status} pairs |
Related tools
create_feature_specwriteCreate and save a feature specificationget_feature_specreadFetch one spec by UUID with full nested detaillist_feature_specsreadFind specs by search/status/priority/tags/etc; supports summary_only for fast scansupdate_feature_specwriteUpdate spec body fields: title, description, status, priority, tags, etc.