Skip to main content
POST
/
voices
/
v1
/
voices
/
{voiceId}
:publish
cURL
curl --location 'https://api.inworld.ai/voices/v1/voices/<voice-id>:publish' \
--header 'Authorization: Basic <api-key>' \
--header 'Content-Type: application/json' \
--data '{
  "displayName": "John",
  "description": "A warm, friendly voice for customer support.",
  "tags": ["support", "conversational"]
}'
{
  "name": "workspaces/your_workspace_id/voices/design-voice-38b05df9",
  "langCode": "EN_US",
  "displayName": "John",
  "description": "A warm, friendly voice for customer support.",
  "tags": [
    "support",
    "conversational"
  ],
  "voiceId": "your_workspace_id__design-voice-38b05df9",
  "source": "IVC"
}
Publishes a preview voice to your voice library. Use this after designing a voice to promote the chosen preview to your voice library. Once published, the voice can be used to synthesize speech like any other voice.

Authorizations

​
Authorization
string
header
required

Your API key. Read permissions are required for GET endpoints. Write permissions are required for POST, PATCH, and DELETE endpoints.

For Basic authentication, please populate Basic $INWORLD_API_KEY

Path Parameters

​
voiceId
string
required

Voice ID of the draft voice to publish. Expected format: {workspace}__{voice}.

Pattern: [^/]+

Body

application/json

Voice metadata to set when publishing.

​
displayName
string

The name of the voice shown in your voice library.

​
description
string

Description of the voice.

​
tags
string[]

Optional labels for filtering and discovery (e.g., "demo", "custom").

Response

A successful response.

Voice resource representing a voice configuration.

​
voiceId
string

ID of the voice. Format: {workspace}__{voice}.

​
langCode
enum<string>
Available options:
EN_US,
ZH_CN,
KO_KR,
JA_JP,
RU_RU,
AUTO,
IT_IT,
ES_ES,
PT_BR,
DE_DE,
FR_FR,
AR_SA,
PL_PL,
NL_NL,
HI_IN,
HE_IL
​
displayName
string

The human-readable name shown anywhere the voice is listed or selected.

​
description
string

Longer blurb that explains the voice's tone, accent, use cases, or other relevant attributes. Helpful for search and selection.

​
tags
string[]

Flat list of labels used for filtering, grouping and discovery. Examples could include gender, age or use case.

​
name
string

Resource name. Format: workspaces/{workspace}/voices/{voice}.

​
source
enum<string>

The source of the voice:

  • SYSTEM: Built-in voice provided by Inworld.
  • IVC: Instant Voice Clone—user-cloned voice from audio, or voice created via Text Voice Design.
  • PVC: Professional Voice Cloning.
Available options:
SYSTEM,
IVC,
PVC