Delete custom avatar · DeutschlandGPT

Deletes a workspace-owned custom avatar (removes it from HeyGen and the registry).

DELETEhttps://api.deutschlandgpt.de/v2/videos/avatars/{id}

Example request

curl https://api.deutschlandgpt.de/v2/videos/avatars/{id} \
  -X DELETE \
  -H "Authorization: Bearer $DGPT_API_KEY"

curl https://api.deutschlandgpt.de/v2/videos/avatars/{id} \
  -X DELETE \
  -H "Authorization: Bearer $DGPT_API_KEY"

import os, requests

response = requests.delete(
    "https://api.deutschlandgpt.de/v2/videos/avatars/{id}",
    headers={"Authorization": f"Bearer {os.environ['DGPT_API_KEY']}"},
)

print(response.json())

import os, requests

response = requests.delete(
    "https://api.deutschlandgpt.de/v2/videos/avatars/{id}",
    headers={"Authorization": f"Bearer {os.environ['DGPT_API_KEY']}"},
)

print(response.json())

const response = await fetch('https://api.deutschlandgpt.de/v2/videos/avatars/{id}', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DGPT_API_KEY}`,
  },
});

console.log(await response.json());

const response = await fetch('https://api.deutschlandgpt.de/v2/videos/avatars/{id}', {
  method: 'DELETE',
  headers: {
    Authorization: `Bearer ${process.env.DGPT_API_KEY}`,
  },
});

console.log(await response.json());

Parameters

idstring<uuid>required

Response

200application/json

{
  "id": "00000000-0000-0000-0000-000000000000",
  "object": "avatar",
  "deleted": true
}

{
  "id": "00000000-0000-0000-0000-000000000000",
  "object": "avatar",
  "deleted": true
}

Deleted.

idstring<uuid>

objectstring

deletedboolean

Response codes

200

Deleted.

object

401

Unauthorized

404

Avatar not found in this workspace