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

# Namespace Settings

> Settings a namespace carries, shared by every profile in it — today, summary instructions.

A **namespace** carries settings that apply to every profile in it, read and changed on one endpoint:

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

Today there is one setting: **summary instructions**.

## Summary instructions

Free-form instructions that steer how a profile's [summary card](/docs/agent-memory/recall#prime-a-session-before-the-first-turn) reads — shared by every profile in the namespace.

```bash theme={null}
curl -X PATCH "https://api.telnyx.com/v2/ai/memory/namespaces/default/settings" \
  -H "Authorization: Bearer $TELNYX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"summary": {"instructions": "Lead with the plan tier. Keep it under 100 words."}}'
```

Read them back with `GET` on the same path. `instructions: null` means none are set and summaries use the neutral default.

| Behaviour      |                                                                                                                   |
| -------------- | ----------------------------------------------------------------------------------------------------------------- |
| Omitted fields | Left as they are — `{}` changes nothing                                                                           |
| Clearing       | `null`, empty, or whitespace-only                                                                                 |
| Length         | 2000 characters. A longer note is **refused, not truncated** — a note cut mid-sentence is a worse steer than none |
| Scope          | Summaries only. Instructions never affect what `recall` returns                                                   |

<Note>
  **A change applies in the background, not instantly.** After you edit the instructions, existing summaries are brought into line over time — a rate-limited sweep converges every profile's card, dormant ones included — so you don't need new activity on a profile for it to pick up the change.
</Note>

Instructions are advisory: they shape emphasis, tone, and what gets foregrounded, and they never contradict or remove a fact a profile's memories establish.

## Related

* [Recalling memories](/docs/agent-memory/recall) -- the summary card these instructions steer
* [Isolation](/docs/agent-memory/isolation) -- what a namespace is, and how it isolates