Every field on an agent identity, what it accepts, and what it controls. The dashboard reads and manages identities through /api/tenant/agent-configs. The legacy /api/tenant/agent-config endpoint remains for default-identity API compatibility.
| Field | Type | Default | What it does |
|---|---|---|---|
displayName | string, 1–80 characters | — | The agent's name. Shown in your dashboard and used to identify the agent in logs and exports. |
isDefault | boolean | true for the default, false for new identities | Marks the tenant default identity used by outbound calls and inbound DIDs without a specific identity. A persisted tenant can have one default identity. |
systemPrompt | string, 1–8,000 characters | — | The standing instructions that define Terri's tone, boundaries, and phone-call behavior. |
voice | string, 1–80 letters, digits, dot, underscore, or hyphen | platform voice | Optional OpenAI Realtime voice override for this identity. Leave it blank to use the platform voice. |
callerLocale | auto or a supported BCP-47 language tag | "auto" | Language Terri greets and answers in on this identity. auto follows the caller. A pinned locale such as es or fr is the first language on the line; Terri still switches if the caller does. |
enabledChannels | array of "voice_inbound" | "voice_outbound" | — | Server-managed voice channels. Account and support SMS is handled separately from this voice channel setting. |
allowedOutboundPrefixes | array of non-empty strings | ["+1"] | E.164 prefixes Terri is allowed to call. Calls outside these prefixes are blocked. |
handoffPhoneNumbers | array of E.164 phone numbers | [] | Configured owner or handoff numbers Terri can conference into a live call without dropping the original party. |
maxCallDurationSeconds | integer, 30–7200 | 1800 | Call length in seconds for outbound call creation and classic voice actions. The current Realtime stream answer path does not enforce this value when starting a normal inbound stream. |
recordingMode | "off" | "metadata" | "audio" | "metadata" | What is kept from calls. "off" keeps nothing beyond the log entry, "metadata" keeps transcripts and call details without audio, "audio" also stores the recording. |
retentionDays | integer, 1–3650 | 90 | How many days conversation history and call records are retained before deletion. |
callerMemoryMode | "off" | "opt_in" | "off" | Controls whether outside callers can use memory with this identity. "opt_in" still requires the matching contact to have agentMemoryEnabled set to true. |
The remaining fields — id, tenantId, createdAt, and updatedAt — are set by the API and returned on every read; you never send them when updating.