> ## Documentation Index > Fetch the complete documentation index at: https://docs.revring.ai/llms.txt > Use this file to discover all available pages before exploring further. # Add Studio Voice > Add a Studio library voice to your organization's voices. The returned voice `id` is used like any other voice (an agent's `voiceId`, or a per-call `voiceId`). Adding the same library voice again returns the existing voice. Calls that use a Studio voice are billed an additional 2 cents per minute. ## OpenAPI ````yaml POST /voices/studio openapi: 3.1.0 info: title: RevRing Voice AI API description: >- RevRing Voice AI platform API for managing AI voice agents, phone calls, SIP trunks, and analytics. Build intelligent voice applications that can handle inbound and outbound phone calls with AI-powered conversational agents. version: 1.0.0 contact: name: RevRing Support url: https://revring.ai servers: - url: https://api.revring.ai/v1 description: Production API security: - apiKeyAuth: [] tags: - name: Messaging Connections description: Connect messaging providers so agents can send text messages - name: Messages description: Send text messages and read your message log - name: Conversations description: List and clear managed conversation threads - name: SIP Trunks description: Manage SIP trunks for connecting agents to the phone network - name: Agents description: Manage AI voice agents and their configuration - name: Agent Folders description: Organize agents into folders for dashboard navigation - name: Calls description: Manage and query phone calls - name: Analytics description: Get analytics and metrics about your calls - name: Knowledge Bases description: >- Manage knowledge bases and sources for agent retrieval-augmented generation - name: Test Suites description: Manage test suites, test cases, and test runs for agent evaluation - name: Voices description: Browse the voices available to your organization for agent speech paths: /voices/studio: post: tags: - Voices summary: Add Studio Voice description: >- Add a Studio library voice to your organization's voices. The returned voice `id` is used like any other voice (an agent's `voiceId`, or a per-call `voiceId`). Adding the same library voice again returns the existing voice. Calls that use a Studio voice are billed an additional 2 cents per minute. operationId: addStudioVoice requestBody: required: true content: application/json: schema: type: object required: - voiceId properties: voiceId: type: string description: Studio library voice ID from Search Studio Library displayName: type: string description: >- Name to show for the voice (1 to 80 characters). Defaults to the library name. language: type: string description: >- Language code (e.g. 'en'). Defaults to the library voice's language. gender: type: string description: '''female'' or ''male'', when known' responses: '201': description: The voice, now available to your organization content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/Voice' '400': description: Invalid body, or the organization's voice limit was reached content: application/json: schema: type: object properties: error: type: string example: voice_limit message: type: string '401': $ref: '#/components/responses/UnauthorizedError' '403': description: Studio voices are not enabled for your organization content: application/json: schema: type: object properties: error: type: string example: not_enabled message: type: string '404': description: That Studio voice is not available content: application/json: schema: type: object properties: error: type: string example: not_found message: type: string components: schemas: Voice: type: object description: >- A voice available to your organization. Use its `id` as an agent's `voiceId`. properties: id: type: string description: >- Unique identifier, used as an agent's `voiceId` (e.g. 'revring-rachel') displayName: type: string description: Human-readable voice name language: type: string description: Language code the voice speaks (e.g. 'en') gender: type: string nullable: true description: Voice gender, when known ('female' | 'male') category: type: string nullable: true description: Grouping label for the voice (e.g. 'English') source: type: string description: >- Origin of the voice: 'system' for built-in voices, 'cloned' / 'designed' for your organization's custom voices, or 'studio' for a Studio voice added from the Studio library tier: type: string enum: - standard - studio description: >- Voice tier. 'studio' voices are premium voices with the most natural delivery; calls that use one are billed an additional 2 cents per minute on top of the call's regular rate. status: type: string description: 'Readiness of the voice: ''ready'', ''processing'', or ''failed''' required: - id - displayName - language - source - status responses: UnauthorizedError: description: Authentication required or API key invalid content: application/json: schema: type: object properties: error: type: string example: unauthorized securitySchemes: apiKeyAuth: type: apiKey in: header name: x-api-key description: >- API key for authentication. Generate API keys from the RevRing dashboard. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.