Skip to main content
POST
Get suggestions

Authorizations

Authorization
string
header
required

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

application/json
endUserId
string
required

Your stable internal user ID. No colon allowed.

Required string length: 1 - 128
Pattern: ^[A-Za-z0-9@._-]{1,128}$
Example:

"u_123"

context
string

The moment the user is in ("user just opened their portfolio page"). Steers retrieval. Defaults to the user's recent activity/goals.

containerTag
string

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.

Required string length: 1 - 128
Example:

"workspace:acme"

Response

Up to 5 grounded suggestions (possibly empty), or a raw fallback.

suggestions
object[]
required

Up to 5 grounded actions; [] when memory is insufficient.

sources
object[]
raw
string

Present only when the model broke the JSON contract — a displayable text fallback. When present, suggestions is [].