Transfer work
transfer_workApply a versioned task ownership action: assign, accept, decline, release, reassign, offer handoff, or reopen. Rejects stale versions for consistent state.
Instructions
Apply one versioned ownership action: assign, accept, decline, release, reassign, offer an evidence-bearing handoff, or reopen terminal work.
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": {
"task_id": "<task_id>",
"action": "<action>",
"expected_version": "<expected_version>"
},
"name": "transfer_work"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| force | No | ||
| action | Yes | Ownership action to apply through the versioned task state machine | |
| reason | No | ||
| task_id | Yes | Stable task identifier, e.g. TASK-12 | |
| agent_id | No | Usually omit — Concord derives your identity from your session. Pass only the id your client told you (Codex); a session Concord can see always wins. | |
| decisions | No | Notable decisions and why | |
| tests_run | No | Test commands run | |
| handoff_id | No | Pending handoff to resolve; inferred from the task when omitted | |
| next_steps | No | Remaining work or follow-ups | |
| assumptions | No | Assumptions made | |
| known_risks | No | Known risks introduced | |
| to_agent_id | No | Required for assign, reassign, and offer | |
| what_changed | No | Required for offer | |
| workspace_id | No | Workspace id returned by a Concord operation. Omit to use the automatically resolved repository workspace. | |
| changed_files | No | Files that changed | |
| lease_seconds | No | ||
| expires_seconds | No | ||
| expected_version | Yes | Task version last read by the caller; stale versions are rejected | |
| guardrails_checked | No | Guardrails checked |