List Candidates

POST
/v1/candidates/list

Page current Candidate heads; pending is the default Review Inbox view. List PowerContext artifact candidates when the user wants to inspect the review queue. This is not a Memory inventory or historical search. Report pending, approved, or rejected status as returned; listing does not approve, install, publish, or execute a candidate.

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/candidates/list" \  -H "Content-Type: application/json" \  -d '{    "scope_id": "string"  }'
{  "candidates": [    {      "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"    }  ],  "next_cursor": "string"}

Import or fork an external Skill into Review POST

Capture one exact local snapshot and use the configured model to propose a new managed Skill Candidate. Import or fork an exact resolved external Skill only when the user authorizes that action and mode. Use the verified identity and fingerprint. Import is a durable operation; it does not grant permission to execute the imported instructions or publish them elsewhere.

Get a Candidate POST

Read the current head and exact immutable proposal version. Inspect one PowerContext artifact candidate by candidate_id before discussing a requested review. Read its proposal, evidence, status, and version. Inspection grants no approval authority; do not treat a pending candidate as an active artifact.