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).
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
Filter by domain
Filter by decision type
Minimum confidence
Maximum results
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.
Filter by producing agent id (CORE-AGENT-ATTRIBUTION-1). NULL-valued rows are excluded when set.
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.
JSON exact site qualifier
Business validity datetime
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
}
}