Capabilities

Voice export

Copy a custom voice into another workspace, or hand it off to another user, using a copy token

Use a copy token to copy one of your custom voices into another workspace. Move it between your own workspaces, or share the token with specific people so they can copy the voice into theirs.

Looking to share a voice publicly with all Inworld users instead? See Voice Sharing. Voice Export is a private transfer to specific people and workspaces; Voice Sharing publishes the voice to the community Voice Library.

Export a voice

Open the voice in the Voice Library

In Portal, select Voices in the sidebar and select one of your custom voices under the My voices tab to open its details panel. Click Export Voice.

List who can redeem the token

Enter the email addresses of the people who can redeem the token. Include your own email to copy the voice into another of your workspaces. Press Enter, comma, or space after each email to add it, or paste a list of addresses.

Create the copy token

Click Create Copy Token, then copy the token and send it to the people you listed. They redeem it from their own workspace via Import Voice (see below).

The token expires 7 days after creation.
Only the emails listed on the token can redeem it.
Each redemption creates an independent copy — later changes to your original voice are not reflected in copies.
Treat copy tokens like secrets: send them directly to the people you listed rather than posting them anywhere public. Even if a token leaks, only the listed emails can redeem it, and it expires on its own after 7 days.

Import a voice

Open Import Voice in the destination workspace

In the destination workspace, open Voices in the sidebar and click Import Voice (next to Create Voice).

Paste the copy token

Paste the copy token the voice owner shared with you. Optionally enter a Voice name — it defaults to the original voice's name.

Copy the voice

Click Copy Voice. A Voice copied to your workspace notification confirms success, and the Edit Voice window opens in case you want to edit the voice's metadata — display name, description, tags, gender, age, and category.

The voice is now your own private, independent voice with its own voice ID, ready to use in the TTS Playground or via the API.

Export and import via API

Use Issue a voice copy token with the source workspace's API key, then pass the returned voiceCopyTokenId to Redeem a voice copy token with the destination workspace's API key. Both keys need voice write permission.

The API authorizes destination workspace IDs rather than user emails. Its tokens are separate from the email-based Portal tokens described above. Each redemption creates an independent private copy, and tokens expire after seven days.