---
title: "Save Characters"
method: POST
path: "/api/v1/ugc-characters/save"
tags: ["ugcCharacters"]
---

# Save Characters

`POST /api/v1/ugc-characters/save`

Save analyzed characters to the database.

Expects a list of character analysis results and saves them to the ugc_characters table.
Only characters without errors and with all required fields will be saved.

Required fields for saving:
- name
- skin_tone
- age_range
- gender
- ethnicity
- background
- image_url (saved as preview_url)

## Request body

- SaveCharactersRequest
  - `characters` CharacterData[], required
    - `image_url` string, required
    - `name` string
    - `skin_tone` string
    - `skin_tone_hex` string
    - `age_range` string
    - `gender` string
    - `ethnicity` string
    - `background` string
    - `background_description` string
    - `confidence` number
    - `error` string, nullable

## Response `200`

Successful Response

- unknown

## 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)