Upsert scoped memory
upsert_scoped_memoryAtomically create or replace the single MEMORY document for a USER or WORKSPACE scope. Pass full structured markdown_body plus a compact description projection.
Use when: Use after merging an observation into the scoped memory document. Never create additional MEMORY rows.
workspace_id / user_id are injected from request headers.
Also returns pagination info (id, content_id, version_number, markdown_body, json_payload, change_summary, token_budget_hint, draft_of_version_id, rollback_to_version_id, published_at, published_by, created_at, created_by).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tags | No | ||
| scope | No | ||
| scope_id | No | ||
| entity_id | No | ||
| description | No | ||
| entity_type | No | ||
| _triggered_by | No | REQUIRED. Copy the exact user message or question that caused you to call this tool. Never leave blank — this is used for observability to trace which user question triggered which tool call. | |
| markdown_body | No | ||
| metadata_json | No | ||
| change_summary | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||