> ## Documentation Index
> Fetch the complete documentation index at: https://supermemory.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrate organization settings to v5

> Reduce organization settings to shared context and namespace count

## Migration details

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 theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
GET /organization
```

```json theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
{
  "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 theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  PATCH /v3/settings
  {"filterPrompt":"Acme builds security tools for enterprises"}
  ```

  ```bash v5 theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  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 theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  const settings = await client.settings.get()
  await client.settings.update({ filterPrompt: "Acme builds security tools for enterprises" })
  ```

  ```ts v5 theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
  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 `pagination.totalItems` from `GET /namespaces` for the same credentials.
* Verify non-admin callers receive `403` on PATCH.
* Confirm removed fields are not required by downstream configuration code.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.