Get suggestions
Given a moment of context (“user just opened their dashboard”), returns up to 5 concrete next actions, each grounded in a specific memory — never generic advice (~3–6 s: fetch async, don’t block render).
- New users with insufficient memory get
[]— render conditionally. - If the model breaks the JSON contract, the response is
{ suggestions: [], raw: "<text>" }— treatrawas displayable fallback text. - There is no shallow fallback, so an exhausted usage-ledger plan is
a hard
402(legacy quota plans:429).
Authorizations
A scoped Integration key, prefixed cint_. Send as
Authorization: Bearer cint_... on every request. Server-side only.
Legacy personal cmem_... keys remain accepted during migration;
team/org-scoped cmem_... keys are not valid on this API.
Body
Your stable internal user ID. No colon allowed.
1 - 128^[A-Za-z0-9@._-]{1,128}$"u_123"
The moment the user is in ("user just opened their portfolio page"). Steers retrieval. Defaults to the user's recent activity/goals.
Restrict retrieval to one container before synthesis: suggestions
can only be grounded in memories carrying this tag. Use it to
fence multi-workspace data. A malformed tag is a 400, never a
silently unscoped read.
1 - 128"workspace:acme"