Resolve and acknowledge a Handoff
Re-resolve one prepared or exact Handoff, check evidence, and capture the receiver's explicit live-state, capability, and authorization checks.
Authorization
BearerAuth Bearer credential resolved to an opaque authenticated Principal by the Server deployment.
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
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" }'{ "receipt_identity": { "principal": { "type": "user", "id": "string", "description": "string" }, "receiver_identity_matches": true }, "resolution": { "trust": "untrusted_history", "status": "empty", "scope_id": "string", "content": { "generation": { "scope_id": "string", "prompt_key": "handoff.generate", "selection": "built_in", "artifact": { "family": "string", "artifact_id": "string", "revision": 1 }, "definition_version": "string", "builtin_version": "string", "compiled_digest": "string", "original_draft_digest": "string", "edit_status": "unchanged" }, "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.