Hand off current work in one high-level operation

POST
/v1/work/handoffs/prepare-current

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

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

application/json

curl -X POST "https://example.com/v1/work/handoffs/prepare-current" \  -H "Content-Type: application/json" \  -d '{    "scope_id": "string",    "source_id": "string",    "handoff": {      "schema": "powercontext.current-work-handoff.v1",      "trust": "untrusted_input",      "objective": "string",      "state": [        {          "text": "string",          "basis": "declared",          "evidence": [            {              "kind": "source",              "source_ref": {                "name": "string",                "source_id": "string"              }            }          ]        }      ],      "disposition": "continuable",      "next_action": {        "text": "string",        "basis": "declared",        "evidence": [          {            "kind": "source",            "source_ref": {              "name": "string",              "source_id": "string"            }          }        ]      },      "omissions": [        "string"      ]    }  }'
{  "boundary": {    "kind": "work-contract",    "source": {      "name": "string",      "source_id": "string"    },    "position": 1,    "content_digest": "stringstringstringstringstringstringstringstringstringstringstringstrin"  },  "handoff": {    "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"            }          }        }      ]    }  }}

Create a grounded Work Contract POST

Persist an inspectable delegation baseline without granting execution authority.

Resolve and acknowledge a Handoff POST

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