Finalize an inspected Handoff Draft

POST
/v1/handoff/finalize

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.

Authorization

BearerAuth
AuthorizationBearer <token>

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/finalize" \  -H "Content-Type: application/json" \  -d '{    "scope_id": "string",    "draft": {      "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"            }          }        }      ]    }  }'
{  "generation": {    "receipt": "string"  },  "schema": "powercontext.prepared-handoff.v1",  "scope_id": "string",  "base": {    "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"          }        }      }    ]  }}

Generate an inspectable Handoff Draft POST

Requires exact returned Source or Artifact citations, never raw facts or invented references. If none exists, capture the inspected facts as a Source first. Prepare an inspectable PowerContext Handoff Draft from exact evidence for a requested transfer. Inspect facts, omissions, and the next action before finalizing. The Draft is temporary and grants no authority; preparation is not a durable commit or proof that a receiver continued the work.

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.