Voice profiles API
Workspace voice-profile records for phone configuration.
Reviewed against the implementation · September 25, 2026
List profiles
GET /api/v1/voice-profiles requires an authenticated agent and the phones feature. It returns the workspace’s public voice-profile records. It does not enumerate other workspaces. Returned records include provider and providerVoiceId; treat these as opaque configuration values, not credentials.
Create a profile
POST /api/v1/voice-profiles requires an administrator and the phones feature. The route validates a display name and optional profile settings, then creates a workspace record. Use the current request schema in the workspace client when integrating this administrative surface.
Provisioning boundary
The create route is not an audio-upload or voice-cloning endpoint. A successful profile record does not prove that a provider voice has been enrolled or is available to the deployed voice worker.
Check selection and playback
Verify the profile belongs to the intended workspace, select the permitted voice through phone settings and run a test call. Contact support for current voice enrollment availability.