Common Mistakes

Greetings, "ok thanks", and other chatter are caught by an internal low-value detector. The API returns 2xx with status="skipped" — not an error. Treat skipped as a business outcome, not a transport failure.

• Generic summaries — patterns like "This is a file" or "Untitled".
• Metadata-only content — JSON blobs, URLs, or arrays with no semantic substance.
• Redundant key_points — pairs with more than 80% word overlap.
• Vague filler language — text built from padding phrases ("the data shows", "contains information about") without concrete facts.

ttl_minutes is an absolute deadline that drives expires_at. It does not weight ranking. Use importance for weighting, ttl_minutes for hard expiry.

• Sending body user_id hoping the server will trust it — overwritten with the resolved end-user.
• Setting environment, project_id, or user_id in metadata to bypass the column — ignored; reads still filter on the columns.
• Using an API key from one tenant with an X-Tenant-ID for another — 403.

• Switching the tenant default model without re-embedding existing rows — query and row dimensions stop matching, recall silently drops.
• Pre-computing embeddings on the client — the platform re-embeds on the server using semantic-enriched text; client-side vectors are not used.

• JWT request that also sends X-End-User-ID — the header is ignored. Confusing in logs.
• Service-auth memory call that omits X-End-User-ID — 400.
• Sending X-Project-ID for a project that does not belong to the resolved tenant — 403.

• Storing User.id (the integer) in the client — it is internal and may change shape. Store public_id.
• Storing the raw refresh token instead of letting the auth flow handle rotation — the token's hash is on the server; the plaintext is not.
• Parsing project_id shape in the client — treat it as opaque.

• Polling /memory/query to see whether a delete completed — listen for the lifecycle event instead.
• Assuming a soft-deleted memory is gone — it is recoverable until hard_delete_at.
• Calling /memory/user/purge for routine cleanup — it is a one-shot, irreversible action.