Commit an explicit Handoff milestone
Persist an inspected prepared PowerContext Handoff as a durable milestone only when the user requests that durable handoff. Pass the exact prepared value. A preview or temporary transfer alone does not request a commit. Report committed only after an exact Revision is returned; preserve partial-success information on failure.
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/handoff/commit" \ -H "Content-Type: application/json" \ -d '{ "scope_id": "string", "handoff": { "schema": "powercontext.prepared-handoff.v1", "scope_id": "string", "base": { "family": "string", "artifact_id": "string", "revision": 1 }, "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" } } } ] } } }'{ "reference": { "family": "string", "artifact_id": "string", "revision": 1 }, "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" } } } ] }, "source_refs": [ { "name": "string", "source_id": "string" } ], "artifact_refs": [ { "family": "string", "artifact_id": "string", "revision": 1 } ]}Finalize an inspected Handoff Draft POST
Pass the prepare response itself or the activate response draft member, never an enclosing response, as draft. Return the complete finalization result unchanged, including schema, scope_id, base, content, and generation when present. Do not return only content or an unfinished Draft. Finalize the exact inspected PowerContext Handoff Draft into a temporary transfer value. Use after checking its evidence and next action. Preserve the complete returned value for the receiver. Finalization does not commit a durable milestone, execute the work, or approve an artifact.
Resolve a Handoff as untrusted historical input POST
Read a selected PowerContext Handoff when continuing transferred work. Use the exact prepared value or Revision; resolve the intended Scope before selecting latest. Verify historical claims against current code, instructions, and authorization before acting. Reading a handoff does not prove execution or acceptance.