Propose a memory review item (create, update, supersede, archive, ...).

POST

/api/memories/reviews

const url = 'https://example.com/api/memories/reviews';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: '{"action":"example","confidence":1,"evidence":"example","importance":1,"kind":"example","pinned":true,"project_id":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","reason":"example","related_memory_id":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","scope":"example","source_id":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","source_type":"example","target_memory_id":"2489E9AD-2EE2-8E00-8EC9-32D5F69181C0","text":"example","title":"example"}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://example.com/api/memories/reviews \
  --header 'Content-Type: application/json' \
  --data '{ "action": "example", "confidence": 1, "evidence": "example", "importance": 1, "kind": "example", "pinned": true, "project_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "reason": "example", "related_memory_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "scope": "example", "source_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "source_type": "example", "target_memory_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "text": "example", "title": "example" }'

Request Body^required

application/json

object

action

required

string

confidence

#1392 — the producer’s confidence in this proposal, 0..1. A producer with an honest signal (the council judge’s judge_confidence) sets it; a producer with none leaves it None, which stores NULL and renders “Unknown” in the review detail. Never fabricated from importance.

number | null format: double

evidence

importance

number | null format: double

kind

string | null

pinned

boolean | null

project_id

string | null format: uuid

reason

string | null

related_memory_id

string | null format: uuid

scope

string | null

source_id

string | null format: uuid

source_type

string | null

target_memory_id

string | null format: uuid

text

string | null

title

#903 — an optional short TITLE for the proposal, rendered as the inbox row label. Absent keeps the pre-#903 shape (the frontend falls back to the evidence’s task title, then to a text snippet).

string | null

Example^generated

{
  "action": "example",
  "confidence": 1,
  "evidence": "example",
  "importance": 1,
  "kind": "example",
  "pinned": true,
  "project_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "reason": "example",
  "related_memory_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "scope": "example",
  "source_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "source_type": "example",
  "target_memory_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "text": "example",
  "title": "example"
}

Responses

200

Newly proposed memory review item

application/json

object

action

required

string

applied_memory_id

string | null format: uuid

created_at

required

string format: date-time

created_by

string | null format: uuid

evidence

required

string format: uuid

proposed_confidence

#1392 — the producer’s CONFIDENCE in this proposal, 0..1, or NULL when the producer has no honest signal (closeout reports, outcome-heuristic candidates, agent/manual proposals that name none). Council candidates carry the judge’s own judge_confidence. Distinct from proposed_importance: importance says how much a memory matters, confidence says how sure the producer is. The review detail renders the value, or an explicit “Unknown” when this is NULL.

number | null format: double

proposed_importance

number | null format: double

proposed_memory_kind

string | null

proposed_pinned

boolean | null

proposed_project_id

string | null format: uuid

proposed_scope

string | null

proposed_text

string | null

proposed_title

#903 — the proposal’s own short TITLE (“Closeout: ”). Before this column the inbox sliced a “title” off the first 80 chars of proposed_text, which is the agent’s summary — so every row read as a sentence fragment. NULL on pre-#903 rows; the frontend then falls back to the closeout evidence’s task title and finally to the text snippet.

string | null

reason

string | null

related_memory_id

string | null format: uuid

reviewed_at

string | null format: date-time

reviewed_by

string | null format: uuid

source_id

string | null format: uuid

source_type

required

string

status

required

string

target_memory_id

string | null format: uuid

updated_at

required

string format: date-time

workspace_id

required

string format: uuid

Example^generated

{
  "action": "example",
  "applied_memory_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "created_at": "2026-04-15T12:00:00Z",
  "created_by": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "evidence": "example",
  "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "proposed_confidence": 1,
  "proposed_importance": 1,
  "proposed_memory_kind": "example",
  "proposed_pinned": true,
  "proposed_project_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "proposed_scope": "example",
  "proposed_text": "example",
  "proposed_title": "example",
  "reason": "example",
  "related_memory_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "reviewed_at": "2026-04-15T12:00:00Z",
  "reviewed_by": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "source_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "source_type": "example",
  "status": "example",
  "target_memory_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0",
  "updated_at": "2026-04-15T12:00:00Z",
  "workspace_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"
}

400

Structured client error

application/json

The canonical JSON body of every error response — the single source of truth the frontend binds to. Every AppError serializes as this exact shape, and the generated OpenAPI component ApiErrorBody (with its ErrorCode enum) is what the frontend error schema is generated from, so there is no hand-written error schema on either end.

object

code

required

Machine-readable, stable error code.

string

Allowed values: not_found unauthorized forbidden license_required license_expired bad_request unprocessable precondition_failed conflict method_not_allowed rate_limited too_many_requests quota_exceeded database_error docker_error vault_error internal_error

details

One of:

null
object

null

Present only on a quota-exceeded 403 — the inline upgrade-CTA payload.

object

key

required

The entitlement feature key that was hit, e.g. apps.max_count.

string

limit

required

The plan’s limit for this key.

integer format: int64

upgrade_url

required

Where to send the user to upgrade.

string

used

required

Current usage (count or bytes, per the key).

integer format: int64

error

required

Human-readable message (the server’s English text; the client may localize by code).

string

Example

{
  "code": "not_found"
}

401

Authentication required

application/json

object

code

required

Machine-readable, stable error code.

string

details

One of:

null
object

null

Present only on a quota-exceeded 403 — the inline upgrade-CTA payload.

object

key

required

The entitlement feature key that was hit, e.g. apps.max_count.

string

limit

required

The plan’s limit for this key.

integer format: int64

upgrade_url

required

Where to send the user to upgrade.

string

used

required

Current usage (count or bytes, per the key).

integer format: int64

error

required

Human-readable message (the server’s English text; the client may localize by code).

string

Example

{
  "code": "not_found"
}

403

Permission denied

application/json

object

code

required

Machine-readable, stable error code.

string

details

One of:

null
object

null

Present only on a quota-exceeded 403 — the inline upgrade-CTA payload.

object

key

required

The entitlement feature key that was hit, e.g. apps.max_count.

string

limit

required

The plan’s limit for this key.

integer format: int64

upgrade_url

required

Where to send the user to upgrade.

string

used

required

Current usage (count or bytes, per the key).

integer format: int64

error

required

Human-readable message (the server’s English text; the client may localize by code).

string

Example

{
  "code": "not_found"
}

500

Structured server error

application/json

object

code

required

Machine-readable, stable error code.

string

details

One of:

null
object

null

Present only on a quota-exceeded 403 — the inline upgrade-CTA payload.

object

key

required

The entitlement feature key that was hit, e.g. apps.max_count.

string

limit

required

The plan’s limit for this key.

integer format: int64

upgrade_url

required

Where to send the user to upgrade.

string

used

required

Current usage (count or bytes, per the key).

integer format: int64

error

required

Human-readable message (the server’s English text; the client may localize by code).

string

Example

{
  "code": "not_found"
}

Propose a memory review item (create, update, supersede, archive, ...).

Request Bodyrequired

Examplegenerated

Responses

200

Examplegenerated

400

Example

401

Example

403

Example

500

Example

Request Body^required

Example^generated

Example^generated