SmartMemory
GET
/memory/decisions

Get all active decisions, optionally filtered.

With provenance_memory_id set, routes to the inverse-provenance query (CORE-DECISION-PROVENANCE-LOOKUP-1). All filtering is delegated to the core method so filter+limit composition is correct. Without it, behaviour is unchanged from the original list path. as_of (SM-ASOF-DECISIONS-1) lists the decisions that held status at that instant. It does not compose with provenance_memory_id (400).

Authorization

AuthorizationBearer <token>

Send Authorization: Bearer <token>. The token is either a Clerk session JWT or a SmartMemory API key (prefix sm_live_, sm_test_, or legacy sk_).

In: header

Query Parameters

domain?|

Filter by domain

decision_type?|

Filter by decision type

min_confidence?Min Confidence

Minimum confidence

limit?Limit

Maximum results

status?|

Lifecycle state to return: active (default when omitted), superseded, retracted or pending. A superseded decision is kept in the graph, so this is how the UI reads history rather than only the current belief.

agent_id?|

Filter by producing agent id (CORE-AGENT-ATTRIBUTION-1). NULL-valued rows are excluded when set.

provenance_memory_id?|

Inverse-provenance filter (CORE-DECISION-PROVENANCE-LOOKUP-1). When set, returns only active decisions whose provenance subgraph (within max_depth hops) contains this memory id. Combined with the other filters: domain/decision_type/min_confidence are applied in-query so the response never silently truncates below limit when more matches exist. Unknown or out-of-scope memory ids return an empty list (never 404) to avoid existence leakage.

business_scope?|

JSON exact site qualifier

valid_at?|

Business validity datetime

as_of?|

ISO 8601 instant (SM-ASOF-DECISIONS-1). Answer as of then: the decisions held at that instant (supersession and retraction honoured), each labelled as_of_resolution. Absent = now. An unparseable value is a 400.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/memory/decisions"
null
{
  "detail": {
    "code": "invalid_scoped_validity",
    "message": "string",
    "retryable": false
  }
}
{
  "detail": {
    "code": "invalid_scoped_validity",
    "message": "string",
    "retryable": false
  }
}
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}
{
  "detail": {
    "code": "invalid_scoped_validity",
    "message": "string",
    "retryable": false
  }
}