update_object
Modify properties of existing objects in Task Trellis MCP, including status, priority, prerequisites, or content. Essential for managing work item lifecycles and maintaining project state efficiently.
Instructions
Updates an existing object in the task trellis system
Use this tool to modify properties of existing objects such as changing status, priority, prerequisites, or content. Essential for managing work item lifecycle and maintaining project state.
Available status values:
'draft': Initial state for new objects
'open': Ready to begin work (default for new objects)
'in-progress': Currently being worked on
'done': Completed successfully
'wont-do': Cancelled or decided against
Available priority values:
'high': Critical or urgent work
'medium': Standard priority
'low': Nice-to-have or future work
Updatable properties:
'status': Progress state (follows workflow: draft → open → in-progress → done)
'priority': Importance level (high, medium, low)
'prerequisites': Dependency relationships (add/remove prerequisite objects)
'body': Detailed description or content of the work item
'force': Bypass certain validation checks when necessary
Common update patterns:
Mark task as ready: status='open'
Start working: status='in-progress'
Change priority: priority='high'
Add dependencies: prerequisites=[...existing, 'new-prereq-id']
Update description: body='detailed work description'
Complete work: status='done'
Cancel work: status='wont-do'
The update maintains object integrity by validating relationships and preserving audit trail. Use 'force=true' only when bypassing standard validation is necessary for administrative operations.
Updates automatically refresh the 'updated' timestamp while preserving creation metadata and change history.
Input Schema
Name | Required | Description | Default |
---|---|---|---|
body | No | Body content of the object (optional) | |
force | No | Force update flag (defaults to false) | |
id | Yes | ID of the object to update | |
prerequisites | No | Array of prerequisite object IDs (optional) | |
priority | No | Priority level (optional) | |
status | No | Status of the object (optional) |