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

# Get a namespace's settings

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

## Request

- Base URL: `https://api.telnyx.com/v2`
- URL: `https://api.telnyx.com/v2/ai/memory/namespaces/{namespace}/settings`
- Auth: HTTP bearer

What is currently set for this namespace. `instructions: null` means none are set and summaries use the neutral default.

## Path parameters

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

## Response `200`

The namespace's settings

- 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
- `502`: Upstream error

## Changes

- **2026-10-15** `a72569d69430`: 1 info
  - endpoint added

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

---

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