> ## Documentation Index
> Fetch the complete documentation index at: https://docs.havincy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List characters

Lists the ready Havincy characters of the workspace (reusable visual identities). A character id can replace the photo in [Create an Encore video](/api-reference/create-encore).

Required permission: `read`. MCP tool: `list_characters`.

<ResponseExample>
  ```json 200 theme={null}
  {
    "object": "list",
    "data": [
      { "id": 21, "object": "character", "name": "Milo", "notes": "Curious little robot", "image_url": "https://havincy.com/rails/active_storage/blobs/proxy/.../milo.png" }
    ]
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.