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>

Static bearer token used when local Server authentication is enabled.

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/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": {    "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"            }          }        }      ]    }  }}

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.