Create a grounded Work Contract

POST
/v1/work/contracts/create

Persist an inspectable delegation baseline without granting execution authority. Record the inspected baseline of explicitly delegated work: objective, evidence, scope, exclusions, completion criteria, and authorization. Ordinary coding or discussion alone does not need a Work Contract. The contract is historical input and grants no authority beyond current instructions.

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/contracts/create" \  -H "Content-Type: application/json" \  -d '{    "scope_id": "string",    "source_id": "string",    "contract": {      "schema": "powercontext.work-contract.v1",      "trust": "untrusted_input",      "objective": "string",      "facts": [        {          "text": "string",          "basis": "declared",          "evidence": [            {              "kind": "source",              "source_ref": {                "name": "string",                "source_id": "string"              }            }          ]        }      ],      "in_scope": [        "string"      ],      "exclusions": [        "string"      ],      "completion_criteria": [        "string"      ],      "authorization_notes": [        "string"      ],      "open_questions": [        "string"      ]    }  }'
{  "kind": "work-contract",  "source": {    "name": "string",    "source_id": "string"  },  "position": 1,  "content_digest": "stringstringstringstringstringstringstringstringstringstringstringstrin"}

Record a bootstrap delivery outcome POST

Atomically claim one pending content-free receipt as injected or failed. A second injected claim is rejected with 422, so concurrent lifecycle hooks cannot both inject the same package. A terminal outcome never changes.

Hand off current work in one high-level operation POST

This operation captures its own boundary; do not call capture_content_source or another Handoff operation first. next_action is one WorkClaim object or null, never an array; omissions is an array of strings or []. Capture an inspected boundary and prepare a temporary evidence-bearing Handoff without committing it. Capture the inspected boundary of a requested work transfer and prepare its Handoff. Use a unique source_id, exact evidence where available, and declared facts otherwise. The returned handoff member is the temporary carrier; commit only for an authorized durable milestone. A preview-only request makes no write. The handoff input contains schema="powercontext.current-work-handoff.v1", trust="untrusted_input", objective, state, disposition, next_action, and omissions. Each state item and non-null next_action is a WorkClaim with text, basis, and evidence (not citations). Facts inspected in the conversation or repository use basis="declared" and evidence=[] unless an exact existing PowerContext citation was returned. Never fabricate a citation for the new source_id or mark a claim verified with empty evidence.