Delete an avatar

October 7, 2026

Table of contents

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

Remove an avatar from the account’s Vids document. This works for avatars made with POST /avatars and for those made in the Google Vids web app, as listed by GET /avatars. Clips already made with the avatar are not affected.

Apart from the one Vids document it creates when you add the account, avatars are the only thing the API saves on a Google account. Generated videos, images and uploads live in Google’s temporary storage and need no deleting, see How long files last.

https://api.useapi.net/v1/google-vids/avatars/avatarId

  • avatarId is the avatar’s id, URL-encoded in the path (it contains : and @). It names its account, so no email is needed.
Request Headers 
Authorization: Bearer {API token}
Responses

  • 204 No Content — the avatar was deleted. The response body is empty.

  • 400 Bad Request — the path value is not an avatarId.

    {
  "error": "Path parameter avatarId (…) is not a valid avatar id",
  "code": 400
}

  • 401 Unauthorized

    Invalid API token.

    {
  "error": "useapi.net ⁝ Unauthorized",
  "code": 401
}

  • 403 Forbidden — the avatarId was issued to a different API token.

    {
  "error": "avatar id does not belong to this API token",
  "code": 403
}

  • 404 Not Found — the avatar is already gone from the Vids document, or its account is not connected.

    {
  "error": "Avatar not found in the Vids document",
  "code": 404
}

  • 502 Bad Gateway — Google did not remove the avatar. Retry.

    {
  "error": "Google did not remove the avatar, please retry",
  "code": 502
}

  • 596 Account Error

    Google reported the account as signed out. While we re-check it, the answer is the first message below. Retry in about a minute. If it stays signed out, the account is paused, you receive an email, and the answer becomes the second message until you re-add it via Setup Google Vids.

    {
  "error": "Google reported this account as signed out. We are re-checking it — please retry in about a minute. If it stays signed out, you will receive a re-add email.",
  "code": 596
}

    {
  "error": "Account [email protected]: Google signed this account out. Re-add it at https://useapi.net/docs/start-here/setup-google-vids",
  "code": 596
}
Model

204 has no body. Errors return:

{ // TypeScript, all fields are optional
  error: string
  code: number
}
Examples 
  • AVATARID="user:[email protected]:eyJnIjoiaDMy…"
curl -X DELETE -H "Authorization: Bearer …" \
     "https://api.useapi.net/v1/google-vids/avatars/$(python3 -c "import urllib.parse,sys;print(urllib.parse.quote(sys.argv[1],safe=''))" "$AVATARID")"

  • const token = "API token";
const avatarId = "avatarId from GET /avatars";
const apiUrl = `https://api.useapi.net/v1/google-vids/avatars/${encodeURIComponent(avatarId)}`;
const response = await fetch(apiUrl, {
  method: "DELETE",
  headers: {
    "Authorization": `Bearer ${token}`,
  },
});
console.log("response", response.status);

  • import requests
from urllib.parse import quote
token = "API token"
avatarId = "avatarId from GET /avatars"
apiUrl = "https://api.useapi.net/v1/google-vids/avatars/" + quote(avatarId, safe="")
headers = {
    "Authorization" : f"Bearer {token}"
}
response = requests.delete(apiUrl, headers=headers)
print(response.status_code)
Try It