---
title: "Create a character (async job)"
method: POST
path: "/v1/studio/series/{seriesId}/characters"
tags: ["Studio"]
---

# Create a character (async job)

`POST /v1/studio/series/{seriesId}/characters`

## Request

- Base URL: `https://api.lizzflix.xyz` (the document declares no server; this is the origin it was published from)
- URL: `https://api.lizzflix.xyz/v1/studio/series/{seriesId}/characters`
- Auth: none declared

## Path parameters

- `seriesId` string, required

## Request body

- LooseJsonBody

## Response `202`

Character creation job accepted

- StudioJobAcceptedResponse
  - `job` StudioAccountJob, required
    - `id` string, required
    - `kind` 'generation' | 'operation'
    - `action` string, nullable
    - `status` string, required
    - `requestId` string, nullable
    - `entityRefs` object
    - `blockingScope` object, nullable
    - `openUrl` string, nullable
    - `result` object, nullable
    - `errorMessage` string, nullable
    - `error` object, nullable
    - `createdAt` string
    - `updatedAt` string
    - `completedAt` string, nullable

## Other responses

- `400`: fromRef is not a reference handle (`reason`)
- `401`: Unauthorized
- `404`: fromRef is not one of your images (`reason` reference_not_found)

---

[API](https://skmtc.dev/lizzflix/apis/lizzflix-api.md) · [All operations](https://skmtc.dev/lizzflix/apis/lizzflix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lizzflix/apis/lizzflix-api/revisions/4536ce9d80ff?raw)