---
title: "Add cropped avatar to a cover"
method: POST
path: "/v1/scenes/wizard/draft/{id}/cover/{coverId}/avatar"
tags: ["Scene Wizard"]
---

# Add cropped avatar to a cover

`POST /v1/scenes/wizard/draft/{id}/cover/{coverId}/avatar`

## Request

- Base URL: `https://api.miaai.chat` (the document declares no server; this is the origin it was published from)
- URL: `https://api.miaai.chat/v1/scenes/wizard/draft/{id}/cover/{coverId}/avatar`
- Auth: HTTP bearer

## Path parameters

- `id` string, required
- `coverId` string, required

## Request body

- AddAvatarDto
  - `s3Key` string, required: S3 key of the uploaded cropped avatar

## Response `201`

Avatar added successfully

- SceneCoverDto
  - `id` string, required
  - `url` string: CDN URL of the cover image
  - `s3Key` string
  - `prompt` string
  - `source` 'UPLOAD' | 'GENERATED', required
  - `status` 'PENDING' | 'COMPLETED' | 'FAILED', required
  - `requestId` string
  - `isSelected` boolean, required
  - `avatarUrl` string: CDN URL of the cropped avatar image
  - `avatarS3Key` string: S3 key for the avatar image
  - `createdAt` string, date-time, required

## Other responses

- `404`: Draft or cover not found

---

[API](https://skmtc.dev/miaai/apis/backend-template-api.md) - [All operations](https://skmtc.dev/miaai/apis/backend-template-api/llms.txt) - [OpenAPI document](https://skmtc.dev/miaai/apis/backend-template-api/revisions/2a8d88a5124f?raw)