Skip to main content
DELETE
/
api
/
characters
/
{character_id}
Delete Character
curl --request DELETE \
  --url https://apis.viggle.ai/api/characters/{character_id} \
  --header 'Authorization: Bearer <token>'
{
  "status": "deleted"
}
Permanently delete a character. This action cannot be undone.
Deleting a character will not affect previously rendered videos, but you won’t be able to use this character in new render jobs.

​
Example

import requests

character_id = "YOUR_CHARACTER_ID"
url = f"https://apis.viggle.ai/api/characters/{character_id}"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}

response = requests.delete(url, headers=headers)
result = response.json()

if result.get("error_code"):
    print(f"Error: {result['error_code']} - {result.get('message')}")
else:
    print("Character deleted successfully")

Authorizations

​
Authorization
string
header
required

API key passed as Bearer token

Path Parameters

​
character_id
string
required

Response

Character deleted

​
status
string
Example:

"deleted"