---
title: "Update settings"
method: PATCH
path: "/v3/settings"
tags: ["Settings"]
---

# Update settings

`PATCH /v3/settings`

Update settings for an organization

## Request body

- union
  - object
    - `workspacePrompt` string, nullable, required
  - object
    - `excludeItems` union
      - string
      - number
      - boolean
      - object
      - unknown[]
        - unknown
    - `filterPrompt` string, nullable
    - `googleDriveClientId` string, nullable
    - `googleDriveClientSecret` string, nullable
    - `googleDriveCustomKeyEnabled` boolean, nullable
    - `includeItems` union
      - string
      - number
      - boolean
      - object
      - unknown[]
        - unknown
    - `notionClientId` string, nullable
    - `notionClientSecret` string, nullable
    - `notionCustomKeyEnabled` boolean, nullable
    - `onedriveClientId` string, nullable
    - `onedriveClientSecret` string, nullable
    - `onedriveCustomKeyEnabled` boolean, nullable
    - `githubClientId` string, nullable
    - `githubClientSecret` string, nullable
    - `githubCustomKeyEnabled` boolean, nullable
    - `shouldLLMFilter` boolean, nullable
    - `chunkSize` integer, nullable
    - `profileBuckets` object[] — Profile bucket definitions
      - `key` string, required — Stable slug for the bucket, stored on each memory
      - `description` string — What belongs in this bucket — used to guide the ingestion classifier.

## Response `200`

Settings updated successfully

- object
  - `orgId` string, required
  - `orgSlug` string, required
  - `updated` object, required
    - `excludeItems` union
      - string
      - number
      - boolean
      - object
      - unknown[]
        - unknown
    - `filterPrompt` string, nullable
    - `googleDriveClientId` string, nullable
    - `googleDriveClientSecret` string, nullable
    - `googleDriveCustomKeyEnabled` boolean, nullable
    - `includeItems` union
      - string
      - number
      - boolean
      - object
      - unknown[]
        - unknown
    - `notionClientId` string, nullable
    - `notionClientSecret` string, nullable
    - `notionCustomKeyEnabled` boolean, nullable
    - `onedriveClientId` string, nullable
    - `onedriveClientSecret` string, nullable
    - `onedriveCustomKeyEnabled` boolean, nullable
    - `githubClientId` string, nullable
    - `githubClientSecret` string, nullable
    - `githubCustomKeyEnabled` boolean, nullable
    - `shouldLLMFilter` boolean, nullable
    - `chunkSize` integer, nullable
    - `profileBuckets` object[] — Profile bucket definitions
      - `key` string, required — Stable slug for the bucket, stored on each memory
      - `description` string — What belongs in this bucket — used to guide the ingestion classifier.
    - `workspacePrompt` string, nullable

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `500` — Internal server error

## Changes

> 8 revisions in range; 5 could not be searched.

- **2026-07-26** `9a2008ad4ee5` — 1 breaking, 18 warning, 2 info
  - the request's body type/format changed from `object`/`` to ``/``
  - removed the request property `chunkSize`
  - removed the request property `excludeItems`
  - removed the request property `filterPrompt`
  - …17 more

[Change history](https://skmtc.dev/supermemory/apis/supermemory-api/changes/v3/settings/patch.md)

---

[API](https://skmtc.dev/supermemory/apis/supermemory-api.md) · [All operations](https://skmtc.dev/supermemory/apis/supermemory-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/supermemory/supermemory-api/revisions/b8c2dbc8f2b5/schema)