Namespace Settings - Telnyx

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 reads — shared by every profile in the namespace.

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

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.

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

Recalling memories — the summary card these instructions steer
Isolation — what a namespace is, and how it isolates