mirror of
https://github.com/supermemoryai/supermemory.git
synced 2026-10-11 03:37:56 +00:00
672defc08b
Rewrites 339 TypeScript calls across 50 pages from the rc.5 `method({ namespace, body })` form to the shipped `method(namespace, { ... })` form, and aligns field names with the live v5 spec: `attach` to `include`, `authUrl` to `authorization`, `lastSync` to `latestRun`, `deletedCount` to `count`, and the paginated `namespaces.list()`.
Renames container tags to namespaces across concepts, connectors, integrations and snippets. The namespace pages keep container tag in the description, search keywords and a rename note so old searches still land, and the v3 reference page points at v5.
The migration guide's SDK table now covers both 5.0.0 SDKs, and the SDK integration page uses the real client options (`baseUrl`, `timeoutInSeconds`, `maxRetries`) and error classes.
39 lines
1.5 KiB
Text
39 lines
1.5 KiB
Text
---
|
|
title: "Profiles"
|
|
sidebarTitle: "Overview"
|
|
description: "Turn accumulated memory into a ready-to-use understanding of a user"
|
|
icon: "/icons/hugeicons/id.svg"
|
|
---
|
|
|
|
| Operation | Purpose |
|
|
| --- | --- |
|
|
| `POST /ns/{namespace}/profile` | Retrieve durable facts, recent context, and custom insights |
|
|
| `GET /ns/{namespace}/profile/buckets` | See the profile categories available here |
|
|
| `PUT /ns/{namespace}/profile/buckets` | Shape the profile with namespace-specific categories |
|
|
| `DELETE /ns/{namespace}/profile/buckets` | Remove namespace-specific categories |
|
|
|
|
<CodeGroup>
|
|
```ts TypeScript
|
|
const { profile } = await supermemory.profile("user_1")
|
|
|
|
await supermemory.profiles.setBuckets("user_1", {
|
|
buckets: { work: "Professional preferences and ongoing work" },
|
|
})
|
|
```
|
|
|
|
```bash curl
|
|
curl -X POST "https://api.supermemory.ai/ns/user_1/profile" \
|
|
-H "Authorization: Bearer $SUPERMEMORY_API_KEY" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{}'
|
|
|
|
curl -X PUT "https://api.supermemory.ai/ns/user_1/profile/buckets" \
|
|
-H "Authorization: Bearer $SUPERMEMORY_API_KEY" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"buckets":{"work":"Professional preferences and ongoing work"}}'
|
|
```
|
|
</CodeGroup>
|
|
|
|
Profiles always contain static and dynamic sections, giving applications both durable knowledge and fresh context without composing them manually. Organization-owned buckets may be inherited but cannot be changed through namespace bucket endpoints.
|
|
|
|
See [profile migration](/migration/api-v5-recall).
|