Rename a cloned voice

November 21, 2026

Table of contents

  1. Request Headers
  2. Path Parameters
  3. Request Body
  4. Responses
  5. Model
  6. Examples
  7. Try It

This endpoint renames a cloned voice, as TemPolor’s website does once a clone is ready. A voice cloned with async=true in POST music/cloned-voices gets its name here: wait until GET music/cloned-voices/clonedVoiceItemId answers status_name COMPLETED (status 30), then send the name.

https://api.useapi.net/v1/tempolor/music/cloned-voices/clonedVoiceItemId

Request Headers
Authorization: Bearer {API token}
Content-Type: application/json
# Alternatively you can use multipart/form-data
# Content-Type: multipart/form-data
Path Parameters
  • clonedVoiceItemId is required. The clonedVoiceItemId returned by a previous POST music/cloned-voices request. It names the account that holds the voice, so no user_id is needed.
Request Body
{
  "name": "My Custom Voice"
}
  • name is required, the new name of the cloned voice.
Responses
  • 200 OK

    {
      "result": true,
      "itemId": "abcdef123456789",
      "name": "My Custom Voice",
      "clonedVoiceItemId": "user:12345-tempolor:user_id-voice:abcdef123456789"
    }
    
  • 400 Bad Request

    {
      "error": "Parameter name is required",
      "code": 400
    }
    
  • 401 Unauthorized

    {
      "error": "Unauthorized",
      "code": 401
    }
    
  • 596 Account signed out

    TemPolor signed the account out, so its session ticket no longer works. The API stops using the account until you add it again with fresh credentials at POST accounts, see Setup TemPolor. Requests without user_id use your other accounts in the meantime.

    {
      "error": "TemPolor signed out account 101441809 (You are currently logged out (400006)). Add it again with POST /v1/tempolor/accounts using fresh credentials, see https://useapi.net/docs/start-here/setup-tempolor",
      "code": 596
    }
    

    If every account you have is in this state, a request without user_id returns 596 as well.

Model

TemPolor’s answer with the voice’s new name, and its clonedVoiceItemId for POST music/song.

The renamed voice, field by field
{   // TypeScript, all fields are optional
    result: boolean
    itemId: string
    name: string
    clonedVoiceItemId: string
    error: string
    code: number
}
Examples
  • curl "https://api.useapi.net/v1/tempolor/music/cloned-voices/user:12345-tempolor:user_id-voice:abcdef123456789" \
      -H "Authorization: Bearer …" \
      -H "Content-Type: application/json" \
      -d '{"name": "My Custom Voice"}'
    
  • const token = "API token";
    const clonedVoiceItemId = "user:12345-tempolor:user_id-voice:abcdef123456789";
    const apiUrl = `https://api.useapi.net/v1/tempolor/music/cloned-voices/${clonedVoiceItemId}`;
    
    const response = await fetch(apiUrl, {
      method: "POST",
      headers: {
        "Authorization": `Bearer ${token}`,
        "Content-Type": "application/json"
      },
      body: JSON.stringify({ name: "My Custom Voice" })
    });
    const result = await response.json();
    console.log("response", {response, result});
    
  • import requests
    
    token = "API token"
    cloned_voice_item_id = "user:12345-tempolor:user_id-voice:abcdef123456789"
    apiUrl = f"https://api.useapi.net/v1/tempolor/music/cloned-voices/{cloned_voice_item_id}"
    headers = {
        "Authorization": f"Bearer {token}",
        "Content-Type": "application/json"
    }
    
    response = requests.post(apiUrl, headers=headers, json={"name": "My Custom Voice"})
    print(response.status_code, response.json())
    
Try It