Delete Character

June 5, 2026

Table of contents

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

Delete a character. The attached voice (if any) is not deleted — voices have their own lifecycle.

https://api.useapi.net/v1/google-flow/characters/ref

Path Parameters

Request Headers 

Authorization: Bearer {API token}

Responses

  • 200 OK

    {
  "deleted": true,
  "entityId": "f470f1b5-...",
  "character": "user:12345-email:6a6f...-character:f470f1b5-...-imgs:2-voice:d990a2f9-..."
}

  • 400 Bad Request

    { "error": "Parameter character has incorrect format" }

  • 403 Forbidden

    { "error": "Unauthorized access to user:12345 detected in character reference" }

  • 404 Not Found

    { "error": "Character not found: f470f1b5-..." }

Model 

{
  deleted: true
  entityId: string
  character: string              // echoes the reference-id passed in
}

Examples 

  • REF="user:12345-email:6a6f...-character:f470f1b5-...-imgs:2"
REF_ENC=$(printf '%s' "$REF" | jq -sRr @uri)
curl -X DELETE \
     -H "Authorization: Bearer YOUR_API_TOKEN" \
     "https://api.useapi.net/v1/google-flow/characters/$REF_ENC"

  • const ref = 'user:12345-email:6a6f...-character:f470f1b5-...-imgs:2'
const r = await fetch(
  `https://api.useapi.net/v1/google-flow/characters/${encodeURIComponent(ref)}`,
  { method: 'DELETE', headers: { 'Authorization': `Bearer ${token}` } }
)
const { deleted } = await r.json()
console.log('deleted:', deleted)

  • import requests, urllib.parse
ref = 'user:12345-email:6a6f...-character:f470f1b5-...-imgs:2'
r = requests.delete(
    f'https://api.useapi.net/v1/google-flow/characters/{urllib.parse.quote(ref, safe="")}',
    headers={'Authorization': f'Bearer {token}'},
)
print('deleted:', r.json().get('deleted'))

Try It