mirror of
https://github.com/supermemoryai/supermemory.git
synced 2026-10-29 06:36:43 +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.
74 lines
2.2 KiB
Text
74 lines
2.2 KiB
Text
v5 exposes only the organization-wide context needed to guide memory formation. Internal controls and profile bucket mutation are no longer part of this settings resource.
|
|
|
|
### Endpoint mapping
|
|
|
|
| Legacy | v5 |
|
|
| --- | --- |
|
|
| `GET /v3/settings` | `GET /organization` |
|
|
| `PATCH /v3/settings` | `PATCH /organization` |
|
|
| `filterPrompt` | `organizationalContext` |
|
|
|
|
### Read organization settings
|
|
|
|
```bash
|
|
GET /organization
|
|
```
|
|
|
|
```json
|
|
{
|
|
"organizationalContext": "Acme builds security tools for enterprises",
|
|
"namespaceCount": 42
|
|
}
|
|
```
|
|
|
|
Remove readers for legacy settings that are not present in this allowlisted response. `namespaceCount` is informational and cannot be changed through PATCH.
|
|
|
|
### Update organization context
|
|
|
|
<CodeGroup>
|
|
```bash Legacy
|
|
PATCH /v3/settings
|
|
{"filterPrompt":"Acme builds security tools for enterprises"}
|
|
```
|
|
|
|
```bash v5
|
|
PATCH /organization
|
|
{"organizationalContext":"Acme builds security tools for enterprises"}
|
|
```
|
|
</CodeGroup>
|
|
|
|
The field is exhaustive: the supplied value replaces the existing context. Send `null` to remove it. Empty strings are rejected.
|
|
|
|
Organization updates require an organization administrator. Do not silently fall back to namespace context when the caller receives `403`.
|
|
|
|
### With the SDK
|
|
|
|
<CodeGroup>
|
|
```ts Legacy
|
|
const settings = await client.settings.get()
|
|
await client.settings.update({ filterPrompt: "Acme builds security tools for enterprises" })
|
|
```
|
|
|
|
```ts v5
|
|
const { organizationalContext, namespaceCount } = await supermemory.organization.get()
|
|
|
|
await supermemory.organization.update({
|
|
organizationalContext: "Acme builds security tools for enterprises",
|
|
})
|
|
```
|
|
</CodeGroup>
|
|
|
|
### Removed public operations
|
|
|
|
- Organization profile-bucket mutation is not exposed through organization settings.
|
|
- Bucket suggestion is not part of v5.
|
|
- Organization data reset is not part of v5.
|
|
- Namespace-owned profile buckets are managed through `/ns/{namespace}/profile/buckets`.
|
|
|
|
### Verification
|
|
|
|
- Compare the v5 context with the legacy `filterPrompt` before cutover.
|
|
- Set, replace, and clear organizational context.
|
|
- Confirm `namespaceCount` agrees with `GET /namespaces` for the same credentials.
|
|
- Verify non-admin callers receive `403` on PATCH.
|
|
- Confirm removed fields are not required by downstream configuration code.
|