Resolve a Handoff as untrusted historical input
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.
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
curl -X POST "https://example.com/v1/handoff/continue" \ -H "Content-Type: application/json" \ -d '{ "scope_id": "string", "selection": "prepared" }'{ "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" } } ] } ]}Commit an explicit Handoff milestone POST
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.
Prepare optional compact continuity hints from a selected Handoff POST
Explicitly request untrusted historical orientation for a fresh session. Select an exact Revision, a complete transferred PreparedHandoff, or latest only after resolving the intended workstream Scope. Hints project existing Handoff fields and authorized evidence references without transcript summaries or model generation. They never replace full Handoff reads, evidence checks, current instructions, or live validation. The complete rendered UTF-8 hint is limited to max_bytes (at most 4000); omit it rather than truncate when budget or evidence is insufficient. Blocked hints include the full recorded state only when the complete hint fits. Authorization matches Continue: exact/latest require artifact.read and handoff.evidence.inspect on the selected Handoff, covering only its citation manifest without general Scope read; prepared requires scope.read. General evidence APIs retain their independent permission checks. Prepared selection provides no exact Revision reference; the receiver must retain the complete transferred PreparedHandoff.