---
title: "Change a namespace's settings"
method: PATCH
path: "/ai/memory/namespaces/{namespace}/settings"
tags: ["Settings"]
---

# Change a namespace's settings

`PATCH /ai/memory/namespaces/{namespace}/settings`

Only the fields you send are changed; anything omitted is left as it is, so `{}` changes nothing. Sending `instructions: null`, or an empty or whitespace-only string, clears them and returns summaries to the neutral default.

Instructions are capped at 2000 characters. A longer note is refused rather than truncated, because a note cut mid-sentence is a worse steer than none. A change reaches each summary the next time that summary is regenerated, not immediately.

## Path parameters

- `namespace` string, required — The namespace. `default` exists for every organization.

## Request body

- NamespaceSettingsPatch
  - `summary` SummarySettingsPatch — A partial update to a namespace's summary settings. Only the fields present in the request are changed; the rest are left as they are. Sending `instructions: null` (or empty) clears the instructions.
    - `instructions` string, nullable — Replace the namespace's summary instructions. Null or empty clears them and returns to the neutral default. Omit the field to leave the current instructions unchanged.

## Response `200`

The settings as stored

- NamespaceSettingsResponse
  - `data` NamespaceSettings, required — A namespace's settings, grouped by what they affect.
    - `summary` SummarySettings — A namespace's summary settings, shared by every profile in it.
      - `instructions` string, nullable — Free-form instructions that influence how this namespace's summaries are written, shared by every profile in the namespace. How you use them is up to you -- they steer the outcome, so try a phrasing and see how the summary comes out. Advisory: they steer the summary but never override or deny a profile's own facts, and they do not affect recall. Null or empty means none are set, and summaries use the neutral default. A change reaches each summary the next time it is regenerated.

## Other responses

- `401` — Unauthorized
- `404` — The namespace does not exist
- `422` — Invalid request
- `502` — Upstream error

## Changes

> 99 revisions in range; 1 not diffed.

- **2026-09-25** `88481995b4ca` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/ai/memory/namespaces/:namespace/settings/patch.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/revisions/227c33b1ac9c?raw)