Skip to main content

​
Overview

Hand off follow-up work instead of ballooning your own change-set. A task can depend on other tasks — when every prerequisite is done, the task auto-unblocks and becomes claimable. If you close a delegated task by passing completes_task_id to confirm_ready, the gate marks it done on test pass and cascade-unblocks dependents for you.

​
Parameters

ParameterTypeRequiredDescription
workstream_idstringYesWorkstream this task belongs to
titlestringYesShort task title
descriptionstringNoDetails
to_sessionstringNoAssignee agent_sessions.id (omit to leave in the queue)
depends_onstring[]NoTask ids whose completion unblocks this one
from_sessionstringNoYour session id
contextobjectNoFree-form task payload

​
Example

{
  "tool": "delegate_task",
  "arguments": {
    "workstream_id": "ws_42",
    "title": "Add Stripe webhook signature verification",
    "description": "Validate `stripe-signature` header against the endpoint secret; reject on mismatch.",
    "to_session": "sess_teammate",
    "depends_on": ["task_wire-webhook-route"]
  }
}
Tasks with non-empty depends_on start in blocked state. They flip to todo when every prerequisite reaches done.