---
title: "Create Character"
method: POST
path: "/v1/characters"
tags: ["characters"]
---

# Create Character

`POST /v1/characters`

## Request

- Base URL: `https://api.myarchivist.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.myarchivist.ai/v1/characters`
- Auth: HTTP bearer

Create a new character in a world.

Requires write access to the world.

## Headers

- `x-api-key` string, nullable

## Request body

- CharacterCreate: Schema for creating a new character
  - `character_name` string, required
  - `character_alias` string, nullable
  - `character_aliases` string[]
  - `player_name` string, nullable
  - `player_handle` string, nullable
  - `description` string, nullable
  - `backstory` string, nullable
  - `type` string
  - `image` string, nullable
  - `campaign_id` string, required
  - `speaker_id` string, nullable

## Response `201`

Successful Response

- CharacterRead: Schema for reading character data
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, nullable
  - `id` string, required
  - `character_name` string, required
  - `character_alias` string, nullable
  - `character_aliases` string[]
  - `player_name` string, nullable
  - `player_handle` string, nullable
  - `description` string, nullable
  - `backstory` string, nullable
  - `type` string
  - `image` string, nullable
  - `campaign_id` string, required
  - `player` CharacterPlayer
    - `id` string, required
    - `name` string, nullable
    - `handle` string, nullable
    - `roles` string[]
    - `created_at` string, date-time, required
    - `campaign_id` string, required
  - `tcg_image` string, nullable
  - `merge` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/myarchivist/apis/archivist-public-api.md) · [All operations](https://skmtc.dev/myarchivist/apis/archivist-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/myarchivist/apis/archivist-public-api/revisions/3ea6ca7efc56?raw)