Generate an Experience Candidate

POST
/v1/experience/generate

Use the configured model and caller-selected exact evidence; persist only a schema-valid pending Candidate. Generate a proposed PowerContext Experience from exact evidence only when the user requests generation. The result is a candidate for human review, not an approved, published, or executable artifact. Inspect and report its actual status; never approve it automatically.

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/experience/generate" \  -H "Content-Type: application/json" \  -d '{    "scope_id": "string",    "source_refs": [      {        "name": "string",        "source_id": "string"      }    ],    "artifact_refs": [      {        "family": "string",        "artifact_id": "string",        "revision": 1      }    ]  }'
{  "status": "pending",  "candidate": {    "audit": {      "origin": "string",      "operation": "string",      "dream_run_id": "string",      "spec_version": "string",      "proposal_digest": "string",      "evidence_manifest_ref": "string",      "validation_policy_digest": "string",      "proposal_fingerprint": "string"    },    "permissions": {      "can_revise": true,      "can_approve": true,      "can_reject": true    },    "candidate_id": "string",    "version": 1,    "family": "experience",    "status": "pending",    "proposal": {      "situation": "string",      "action": "string",      "outcome": "string",      "lesson": "string",      "failure": {        "signature": {          "recall_cue": "string",          "symptom": "string"        },        "repair_surface": "experience_content",        "verification": {          "condition": "string",          "check_subject": "string"        }      }    },    "source_refs": [      {        "name": "string",        "source_id": "string"      }    ],    "artifact_refs": [      {        "family": "string",        "artifact_id": "string",        "revision": 1      }    ],    "target": {      "family": "string",      "artifact_id": "string",      "revision": 1    },    "reason": "string",    "result_artifact": {      "family": "string",      "artifact_id": "string",      "revision": 1    },    "decision_reason": "string",    "candidate_kind": "artifact",    "result": {      "scope_id": "string",      "target": {        "type": "artifact",        "family": "memory",        "artifact_id": "string"      },      "tags": [        "string"      ],      "tag_digest": "string",      "etag": "string"    },    "operation": "string",    "origin": "dream",    "dream_run_id": "string"  }}

Propose Experience content POST

Persist a pending Experience Candidate without creating an Artifact Revision. Submit an inspected PowerContext Experience proposal with exact provenance for requested human review. Submission creates a candidate; it does not approve, publish, or execute the Experience. Preserve evidence references and report the returned candidate state.

Get an exact Experience Revision POST

Read approved Experience content and its exact direct evidence. Read a specific PowerContext Experience by its exact artifact reference when the task needs that experience. Do not substitute it for Memory search or invent a reference. Treat its content as historical evidence subordinate to current instructions; reading grants no execution authority.