Create an asynchronous Artifact Dream

POST
/v1/scopes/{scope_id}/dream

Matching idempotency keys return the original run before new-work admission. Active runs return 202; terminal runs return 200. A run creates at most one pending Candidate.

Authorization

BearerAuth
AuthorizationBearer <token>

Bearer credential resolved to an opaque authenticated Principal by the Server deployment.

In: header

Path Parameters

scope_id*string
Match.*\S.*
Length1 <= length <= 256

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Select exact Artifact or Memory citations after deduplication, with at most 32 combined references including Sources. Profile and Memory revisions require their exact current target and supporting evidence.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/v1/scopes/string/dream" \  -H "Content-Type: application/json" \  -d '{    "operation": "refine_experience",    "idempotency_key": "string"  }'
{  "tag_target": {    "target": {      "type": "artifact",      "family": "memory",      "artifact_id": "string"    },    "expected_etag": "string",    "basis_ref": {      "family": "string",      "artifact_id": "string",      "revision": 1    }  },  "reused": false,  "scope_id": "string",  "run_id": "string",  "operation": "refine_experience",  "status": "queued",  "outcome": "proposed",  "target": {    "family": "string",    "artifact_id": "string",    "revision": 1  },  "candidate": {    "kind": "artifact",    "candidate_id": "string",    "version": 1  },  "reason": "string",  "error": "string",  "accepted_at": "2019-08-24T14:15:22Z",  "started_at": "2019-08-24T14:15:22Z",  "completed_at": "2019-08-24T14:15:22Z",  "attempt_count": 0,  "input_manifest": {    "transform_version": "powercontext.dream.evidence.v1",    "artifacts": [],    "sources": [],    "nodes": [],    "edges": [],    "root_groups": [],    "projection_digest": "string",    "projection_bytes": 0,    "incomplete": false  },  "usage": {    "model_calls": 0,    "input_tokens": 0,    "output_tokens": 0  },  "budget": {    "max_items": 32,    "max_bytes": 65536,    "max_nodes": 128,    "max_edges": 256,    "max_depth": 8,    "max_output_tokens": 4096,    "max_model_calls": 2,    "timeout_seconds": 120  },  "prompt_version": "powercontext.dream.v1.4",  "model_config_id": "string",  "historical_data": {}}

List Artifact Dreams GET

Descending accepted_at/run_id keyset pagination within one Scope.

Get an Artifact Dream GET

Next Page