Agent configuration

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.

FieldTypeDefaultWhat it does
displayNamestring, 1–80 characters—The agent's name. Shown in your dashboard and used to identify the agent in logs and exports.
isDefaultbooleantrue for the default, false for new identitiesMarks the tenant default identity used by outbound calls and inbound DIDs without a specific identity. A persisted tenant can have one default identity.
systemPromptstring, 1–8,000 characters—The standing instructions that define Terri's tone, boundaries, and phone-call behavior.
voicestring, 1–80 letters, digits, dot, underscore, or hyphenplatform voiceOptional OpenAI Realtime voice override for this identity. Leave it blank to use the platform voice.
callerLocaleauto 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.
enabledChannelsarray of "voice_inbound" | "voice_outbound"—Server-managed voice channels. Account and support SMS is handled separately from this voice channel setting.
allowedOutboundPrefixesarray of non-empty strings["+1"]E.164 prefixes Terri is allowed to call. Calls outside these prefixes are blocked.
handoffPhoneNumbersarray of E.164 phone numbers[]Configured owner or handoff numbers Terri can conference into a live call without dropping the original party.
maxCallDurationSecondsinteger, 30–72001800Call 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.
retentionDaysinteger, 1–365090How 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.