openmemory
Docs
Dreaming

Client-mode dreaming: get the job for your model

GET
/v1/dream/jobs/next

Returns the waiting job, or null. With start_if_due=true, starts a dream first when the last one is older than the dream interval. Call it from a nightly run, give instructions + input to your model, and submit the JSON it returns.

Authorization

headerAuthorizationBearer <token>

Your space key (om_...). Create one with POST /v1/spaces.

Query Parameters

start_if_due?string
Value in"true""false"

Response Body

The job, if any

application/json
  1. response
job*|null
due*boolean
Example Request
curl -X GET 'https://api.openmemory.sh/v1/dream/jobs/next'
Example Response
{  "job": {    "run_id": "string",    "instructions": "string",    "input": {      "property1": null,      "property2": null    },    "output_schema": {      "property1": null,      "property2": null    },    "max_changes": 0  },  "due": true}

Everything an agent needs at the start of a run, in one call GET

Core profile (bounded), due and open records, pending actions, recent journal days, the latest weekly digest, and selected KV namespaces.

Client-mode dreaming: submit your model's result POST

Validated against the job's output schema and applied under the safety rules: pinned and user-stated facts are never rewritten or removed, and at most max_changes are applied. Every change can be undone.