Skip to content

docs update for profile buckets and inferred memory review#1158

Open
sohamd22 wants to merge 1 commit into
mainfrom
06-24-docs_update_for_profile_buckets_and_inferred_memory_review
Open

docs update for profile buckets and inferred memory review#1158
sohamd22 wants to merge 1 commit into
mainfrom
06-24-docs_update_for_profile_buckets_and_inferred_memory_review

Conversation

@sohamd22

@sohamd22 sohamd22 commented Jun 24, 2026

Copy link
Copy Markdown
Contributor

TL;DR

Adds documentation for the Memory Review endpoints and Profile Buckets feature.

What changed?

Memory Review (memory-review.mdx)

  • Added a new documentation page covering the two inferred memory review endpoints: GET /v3/container-tags/{containerTag}/inferred and POST /v3/container-tags/{containerTag}/inferred/{memoryId}/review.
  • Documents the three review actions (approve, decline, undo) and how each affects search ranking and memory state (isInference, isForgotten, reviewStatus).
  • Includes request/response examples in both fetch and cURL, a field reference table, error codes, and a collapsible React Query hooks example for building a review UI.
  • Registered the new page in docs.json under the "Manage Content" group and linked to it from the Memory Operations next steps.

Profile Buckets (user-profiles.mdx)

  • Added a "Profile Buckets" section explaining custom topical categories (preferences, goals, work, etc.) as a complement to static/dynamic profile sections.
  • Documents the include, buckets, and filters query parameters on the profile endpoint.
  • Covers the GET /v4/profile/buckets endpoint for listing configured bucket definitions, with request/response examples and a field reference.
  • Explains the [Recent] / [Summary] label convention used in bucket and dynamic profile entries.
  • Updated the ProfileResponse TypeScript interface to mark static and dynamic as optional and add the buckets field.

How to test?

  • Navigate to the docs site and confirm "Memory Review" appears in the sidebar under "Manage Content".
  • Verify all code examples render correctly and tabs switch between fetch and cURL variants.
  • Confirm the React Query accordion expands and displays the TypeScript snippet.
  • Check that the Profile Buckets section renders inline within the User Profiles page, including the response JSON blocks and the tip/note callouts.

Why make this change?

Inferred (derived) graph memories are down-weighted in search until reviewed, but there was no documentation explaining how to surface or act on them. Similarly, profile buckets were a shipped feature with no public-facing docs. These additions give developers the reference material needed to build review UIs and use topical bucket filtering in their integrations.

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jun 24, 2026

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
supermemory-app 466c869 Commit Preview URL Jun 27 2026, 07:29 PM

sohamd22 commented Jun 24, 2026

Copy link
Copy Markdown
Contributor Author

How to use the Graphite Merge Queue

Add the label Main to this PR to add it to the merge queue.

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

This stack of pull requests is managed by Graphite. Learn more about stacking.

@sohamd22 sohamd22 marked this pull request as ready for review June 24, 2026 12:08
@graphite-app graphite-app Bot requested a review from Dhravya June 24, 2026 12:08
@claude

claude Bot commented Jun 24, 2026

Copy link
Copy Markdown

Claude finished @sohamd22's task in 34s —— View job


Reviewing PR #1158

  • Gather context and understand the changes
  • Review documentation files for issues
  • Check for any bugs or broken links
  • Submit review

Overview: Adds documentation for Memory Review endpoints and Profile Buckets feature.

Issues found: None — this looks good to ship.

This is a documentation-only PR with no executable code. The changes include:

  • New memory-review.mdx documenting the inferred memory review queue and review action endpoints
  • Profile Buckets section added to user-profiles.mdx with clear examples
  • Proper sidebar registration in docs.json
  • Cross-linking from memory operations

The code examples are well-structured with consistent fetch/cURL tabs, the field reference tables are complete, and the TypeScript interface updates correctly reflect the optional nature of static/dynamic when using include filtering.

Score: 10/10

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jun 24, 2026

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Updated (UTC)
✅ Deployment successful!
View logs
supermemory-mcp 466c869 Jun 27 2026, 07:27 PM

@claude claude Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Overview: Adds documentation for Memory Review endpoints and Profile Buckets feature.

Issues found: None — this looks good to ship.

This is a documentation-only PR with no executable code. The changes include:

  • New memory-review.mdx documenting the inferred memory review queue and review action endpoints
  • Profile Buckets section added to user-profiles.mdx with clear examples
  • Proper sidebar registration in docs.json
  • Cross-linking from memory operations

The code examples are well-structured with consistent fetch/cURL tabs, the field reference tables are complete, and the TypeScript interface updates correctly reflect the optional nature of static/dynamic when using include filtering.

Score: 10/10

@mintlify

mintlify Bot commented Jun 24, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
supermemory 🟢 Ready View Preview Jun 24, 2026, 12:12 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

Comment on lines +170 to +172
- **`decline`** — Reject the suggestion: the memory is **forgotten**
(`isForgotten: true`) and stamped `reviewStatus: "declined"`, so it leaves both
search and the review queue.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The decline action description doesn't specify what happens to isInference, but line 191 claims it becomes true after decline. This is inconsistent.

The description states:

- **`decline`** — Reject the suggestion: the memory is **forgotten**
  (`isForgotten: true`) and stamped `reviewStatus: "declined"`

But line 191 says isInference is true after decline. The decline action description should explicitly state what happens to isInference (e.g., isInference remains true or is set to false) to match the behavior documented in the response table.

Suggested change
- **`decline`** — Reject the suggestion: the memory is **forgotten**
(`isForgotten: true`) and stamped `reviewStatus: "declined"`, so it leaves both
search and the review queue.
- **`decline`** — Reject the suggestion: the memory is **forgotten**
(`isForgotten: true`, `isInference: true`) and stamped
`reviewStatus: "declined"`, so it leaves both search and the review queue.

Spotted by Graphite

Fix in Graphite


Is this helpful? React 👍 or 👎 to let us know.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant