handoff_get
Retrieve a handoff by ID to inspect status, claimant, payload, and result, including verification and dependency fields when set.
Instructions
Read a handoff by id: status, claimant, payload, result/rejected_reason + verification/dependency fields if set. The creator's path to the outcome. Full docs: okto-nexus://reference/tool-docs/handoff.
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": {
"project_root": "<project_root>",
"handoff_id": "<handoff_id>",
"agent_id": "<agent_id>"
},
"name": "handoff_get"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent_id | Yes | Your agent_id (REQUIRED). Creator and claimant always read; others are gated by the handoff visibility. | |
| handoff_id | Yes | The handoff_id to act on. REQUIRED. | |
| project_root | Yes | Absolute path to the project (defines the workspace scope). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||