# Character Crafting APIs

The **Character Crafting APIs** give developers full control over how an AI character is designed, configured, and evolved.\
These APIs serve as the foundation of your character’s identity — defining its **personality, behavior, knowledge, and narrative** consistency across all interactions.

With these APIs, you can:

* **Create and manage characters** — define character metadata such as name, description, language.
* **Configure AI settings** through the **Core AI Setting API**, including model selection, temperature.
* **Build and maintain Knowledge Banks** — upload, update, and organize documents that form the character’s domain knowledge.
* **Develop backstories** using the **Backstory API**, providing depth and continuity to your characters.
* **Design narrative elements** via the **Narrative Design API** to create immersive storylines and world-building connections.
* **Define and manage actions** (gestures, movements, or environment-specific behaviors) using the **Action API**.
* **Access language and voice options** via the **Language List** and **Voice List APIs**, allowing multilingual and voice-customized character experiences.
* **Retrieve and manage character lists and versions** through the **Character List API**, ensuring your production characters stay organized and versioned properly.
* **Evaluate and refine** your characters’ responses and performance using the **Evaluation API**.

Together, these APIs let you shape a character’s **core intelligence, emotional tone, and knowledge framework**, ensuring a consistent, believable personality in every conversation.

{% content-ref url="/pages/XWE3BRSoU4D0tOAIAYF9" %}
[Character Base API](/api-docs/api-reference/core-api-reference/character-crafting-apis/character-api.md)
{% endcontent-ref %}

{% content-ref url="/pages/FFi1yUiXmETgoUw75AHX" %}
[Backstory API](/api-docs/api-reference/core-api-reference/character-crafting-apis/backstory-api.md)
{% endcontent-ref %}

{% content-ref url="/pages/UOtHPa6ISx9iKUY1oY8f" %}
[Mindview API](/api-docs/api-reference/core-api-reference/character-crafting-apis/mindview-api.md)
{% endcontent-ref %}

{% content-ref url="/pages/G8p6SIjsyhuaiIN7rkWz" %}
[Core AI Settings API](/api-docs/api-reference/core-api-reference/character-crafting-apis/core-ai-settings-api.md)
{% endcontent-ref %}

{% content-ref url="/pages/oCIidcCW4TDhTMwOM7W8" %}
[Narrative Design API](/api-docs/api-reference/core-api-reference/character-crafting-apis/narrative-design-api.md)
{% endcontent-ref %}

{% content-ref url="/pages/3ggYWwe3Bv6K0A4KMVjn" %}
[Knowledge Bank API](/api-docs/api-reference/core-api-reference/character-crafting-apis/knowledge-bank-api.md)
{% endcontent-ref %}

{% content-ref url="/pages/w9NkMyt9Xl0jW2J3XPzO" %}
[Action API](/api-docs/api-reference/core-api-reference/character-crafting-apis/action-api.md)
{% endcontent-ref %}

{% content-ref url="/pages/5Wcbc7O4hgMexjJCzSIt" %}
[Chat History API](/api-docs/api-reference/core-api-reference/character-crafting-apis/chat-history-api.md)
{% endcontent-ref %}

{% content-ref url="/pages/XWKGoRyiqLL5CSNGM93v" %}
[Evaluation API](/api-docs/api-reference/core-api-reference/character-crafting-apis/evaluation-api.md)
{% endcontent-ref %}

{% content-ref url="/pages/MteKvBX7fweeVkU90Ry4" %}
[Language List API](/api-docs/api-reference/core-api-reference/character-crafting-apis/language-list-api.md)
{% endcontent-ref %}

{% content-ref url="/pages/PfsvJRo5OzlyGVrnZG06" %}
[Voice List API](/api-docs/api-reference/core-api-reference/character-crafting-apis/voice-list-api.md)
{% endcontent-ref %}

{% content-ref url="/spaces/EtUJA212Zc1S9ACc8T4l/pages/oO9thYF55EFX4iuE7zxC" %}
[Character List API](/api-docs/api-reference/core-api-reference/character-crafting-apis/character-list-api.md)
{% endcontent-ref %}


---

# 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://docs.convai.com/api-docs/api-reference/core-api-reference/character-crafting-apis.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.