# Create Character

### 1. Create a character with L-GOS schema

> Note we only accepts the character data on L-GOS schema.

`POST` <https://api.rpggo.ai/v2/character/create>

**Request Body**

same as <https://github.com/RPGGO-AI/l-gos-spec/blob/main/schema_v1/character_v1.md>

<table><thead><tr><th>Name</th><th>Type</th><th width="137">Example Value</th><th>Description</th></tr></thead><tbody><tr><td>name</td><td>String</td><td>"📒 Sample: Dungeon Master"</td><td></td></tr><tr><td>avatar_url</td><td>String</td><td>"https://a.com/xxx.jpg"</td><td>http image url</td></tr><tr><td>background</td><td>String</td><td>"Play a text-based dungeon crawler game. You are the game designer, dungeon master, and host for the game session. I am The player. use the DND 5E system."</td><td></td></tr><tr><td>appearance</td><td>String</td><td>"A dungeon master"</td><td></td></tr><tr><td>traits</td><td>Array</td><td>["Confident", "Creative", "Drama"]</td><td></td></tr><tr><td>tone</td><td>Array</td><td>["Drama"]</td><td></td></tr><tr><td>intro</td><td>String</td><td>"Welcome to my Tavern, Traveler. This is the DND 5E playground."</td><td></td></tr><tr><td>tags</td><td>Array</td><td>["Male", "Game", "Serious", "Narration"]</td><td>See the tags definitions  here: [L-GOS Tags](<a href="https://github.com/RPGGO-AI/l-gos-spec/blob/main/schema_v1/tag_v1.md">https://github.com/RPGGO-AI/l-gos-spec/blob/main/schema_v1/tag_v1.md</a>)<br><br>Just fill in the value under the specific type, case-insensitive<br><br>Only one value can be selected for each type</td></tr><tr><td>opening_line</td><td>String</td><td>"I'm thrilled to be your Dungeon Master for this thrilling journey. Before we begin, let me clarify a few things. Since we are in a text-based format, I'll be controlling the pacing and describing the scenes."</td><td></td></tr><tr><td>creator</td><td>String</td><td>"Your-RPGGO-ID"</td><td>It must be your own user ID, otherwise the character will not appear in your creator tool list</td></tr><tr><td>creator_notes</td><td>String</td><td>""</td><td></td></tr><tr><td>modules</td><td>Array</td><td>[]</td><td>Not supported yet, can be null</td></tr><tr><td>publish_status</td><td>String</td><td>"opensource"</td><td>Optional parameters： opensource published unpublished</td></tr></tbody></table>

{% code title="Sample Curl" lineNumbers="true" %}

```bash
curl --location --request POST 'https://api.rpggo.ai/v2/character/create' \
--header 'Authorization: YOUR-API-KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
  {
    "name": "📒 Sample: Dungeon Master",
    "avatar_url": "xxx.jpg",
    "background": "Play a text-based dungeon crawler game. You are the game designer,  dungeon master, and host for the game session. I am The player. use the DND 5E system.",
    "appearance": "A dungeon master",
    "traits": [
        "Confident",
        "Creative",
        "Drama"
    ],
    "tone": [
        "Drama"
    ],
    "intro": "Welcome to my Tavern, Traveler. This is the DND 5E playground.",
    "tags": [
        "Male",
        "Game",
        "Serious",
        "Narration"
    ],
    "opening_line": "Im thrilled to be your Dungeon Master for this thrilling journey. Before we begin, let me clarify a few things. Since we are in a text-based format, will be controlling the pacing and describing the scenes.",
    "creator": "my_rpggo_user_id",
    "creator_notes": "",
    "modules": [],
    "publish_status": "opensource"
  }
}'
```

{% endcode %}

{% tabs %}
{% tab title="200: OK " %}
{% code lineNumbers="true" %}

```json
{
    "code": 200,
    "message": "success",
    "data": "CN8J7VFR5OB"
}
```

{% endcode %}
{% endtab %}

{% tab title="10000008: Unauthorized " %}

```json
{
    "code": 10000008,
    "message": "Authentication failed，Invalid token"
}
```

{% endtab %}

{% tab title="10000000: Low balance" %}

```json
{​
    "code": 10000000,​
    "message": "user balance is not enough"​
}
```

{% endtab %}
{% endtabs %}

After creating the character succesfully, you will be able to see your character in the \[Creator Tool]\(<https://creator.rpggo.ai/>)

<figure><img src="/files/0uvRsgPL3CS9I3eL1fXF" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.rpggo.ai/dev-docs/creator-api/v2-api/create-character.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.