> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ada.cx/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ada.cx/_mcp/server.

# Persona API now generally available

The Persona API is now generally available. It provides programmatic read and update access to an AI Agent's persona configuration (the settings that shape how the Agent communicates found under *Config > Settings > Preferences*) so persona changes can be managed through code and version control instead of only through the dashboard.

## API endpoints

Two REST endpoints are available for the persona configuration:

* **Get persona** (`GET /v2/persona`): Returns the current persona configuration.
* **Update persona** (`PATCH /v2/persona`): Partially updates the persona. Only the fields included in the request body change; omitted fields keep their existing values.

## What's configurable

The API exposes the public persona fields, including personality, message length, emoji usage, company description, and manners settings such as acknowledgment messages and competitor handling. Agent identity settings (name and avatar) are not part of the persona.

## Get started

* [Persona API reference](/reference/persona/overview) for endpoint details, fields, authentication, error codes, and rate limits.