---
title: "Update Avatar"
method: PUT
path: "/api/v1/avatars-lib/update"
tags: ["avatarsLib", "avatarsLib"]
---

# Update Avatar

`PUT /api/v1/avatars-lib/update`

## Request body

- UpdateAvatarLibDTO
  - `avatar_id` string, uuid4, required
  - `file_name` string, nullable
  - `image_id` string, nullable
  - `person_id` string, nullable
  - `display_name` string, nullable
  - `gender` string, nullable
  - `age` integer, nullable
  - `age_range` string, nullable
  - `ethnicity` string, nullable
  - `vibe_expression` string, nullable
  - `wardrobe` string, nullable
  - `setting` string, nullable
  - `apparent_class_context` string, nullable
  - `tags` union
    - string[]
    - string
  - `hosted_url` string, nullable
  - `shot_type` string, nullable
  - `angle` string, nullable
  - `face_clear` boolean, nullable
  - `resolution` string, nullable
  - `resolution_band` string, nullable
  - `orientation` string, nullable
  - `usable_as_reference` boolean, nullable
  - `review_notes` string, nullable
  - `active` boolean, nullable

## Response `200`

Successful Response

- AvatarsLibResponseDTO
  - `id` string, uuid4, required
  - `file_name` string, nullable
  - `image_id` string, nullable
  - `person_id` string, nullable
  - `display_name` string, nullable
  - `gender` string, nullable
  - `age` integer, nullable
  - `age_range` string, nullable
  - `ethnicity` string, nullable
  - `vibe_expression` string, nullable
  - `wardrobe` string, nullable
  - `setting` string, nullable
  - `apparent_class_context` string, nullable
  - `tags` string[], nullable
  - `hosted_url` string, nullable
  - `shot_type` string, nullable
  - `angle` string, nullable
  - `face_clear` boolean, nullable
  - `resolution` string, nullable
  - `resolution_band` string, nullable
  - `orientation` string, nullable
  - `usable_as_reference` boolean, nullable
  - `review_notes` string, nullable
  - `active` boolean
  - `created_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/brandbooster/apis/fastapi.md) · [All operations](https://skmtc.dev/brandbooster/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/brandbooster/fastapi/revisions/624917d53409/schema)