Resolve and acknowledge a Handoff

POST
/v1/work/handoffs/acknowledge

Re-resolve one prepared or exact Handoff, check evidence, and capture the receiver's explicit live-state, capability, and authorization checks.

Authorization

BearerAuth
AuthorizationBearer <token>

Static bearer token used when local Server authentication is enabled.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/work/handoffs/acknowledge" \  -H "Content-Type: application/json" \  -d '{    "scope_id": "string",    "source_id": "string",    "receiver": "string",    "status": "accepted",    "selection": "prepared"  }'
{  "resolution": {    "trust": "untrusted_history",    "status": "empty",    "scope_id": "string",    "content": {      "schema": "powercontext.handoff.v1",      "objective": "string",      "state": [        {          "text": "string",          "citations": [            {              "kind": "source",              "source_ref": {                "name": "string",                "source_id": "string"              }            }          ]        }      ],      "disposition": "continuable",      "next_action": {        "text": "string",        "citations": [          {            "kind": "source",            "source_ref": {              "name": "string",              "source_id": "string"            }          }        ]      },      "omissions": [        {          "text": "string",          "citation": {            "kind": "source",            "source_ref": {              "name": "string",              "source_id": "string"            }          }        }      ]    },    "selection": "prepared",    "selected_revision": {      "family": "string",      "artifact_id": "string",      "revision": 1    },    "current_revision": {      "family": "string",      "artifact_id": "string",      "revision": 1    },    "evidence_checks": [      {        "claim": "state",        "state_index": 0,        "status": "available",        "unavailable_evidence": [          {            "kind": "source",            "source_ref": {              "name": "string",              "source_id": "string"            }          }        ]      }    ]  },  "receipt": {    "kind": "work-contract",    "source": {      "name": "string",      "source_id": "string"    },    "position": 1,    "content_digest": "stringstringstringstringstringstringstringstringstringstringstringstrin"  }}

Hand off current work in one high-level operation POST

Capture an inspected boundary and prepare a temporary evidence-bearing Handoff without committing it.

Record a completion-aware Task Outcome POST

Preserve one attempt's status and checks, optionally linked to the exact accepted Handoff Receipt that the result covers.