Launch Week 02 wrapped — explore all five launches
Confident AI
Docs
Pricing
Products
LLM Evaluation
LLM Evaluation

Benchmark LLM systems with research-backed metrics.

LLM Observability
LLM Observability

Trace, monitor, and alert on production LLM systems.

AI Red Teaming
AI Red Teaming

Stress-test LLM apps against adversarial attacks.

AI Governance
AI Governance

Enforce AI standards and controls across teams.

Book a DemoSign Up
Book a DemoSign Up

Update Persona

PUThttps://api.confident-ai.com/v2/personas/{personaId}

Renames a persona or rewrites its characteristics, and returns it. Every golden already pointing at this persona picks the new text up on its next simulation, so an edit changes how future conversations are played rather than conversations already simulated. Names are unique within a project; taking another persona's name returns a 409.

PUT/v2/personas/{personaId}
curl -X PUT "https://api.confident-ai.com/v2/personas/{personaId}" \
  -H "CONFIDENT_API_KEY: <PROJECT-API-KEY>" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Frustrated support caller",
  "characteristics": "An impatient customer who has already been transferred twice. Types in lowercase, asks short direct questions, and pushes back when given a generic answer."
}'
200
{
  "success": true,
  "data": {
    "id": "<PERSONA-ID>",
    "name": "Frustrated support caller",
    "characteristics": "An impatient customer who has already been transferred twice. Types in lowercase, asks short direct questions, and pushes back when given a generic answer.",
    "createdAt": "2025-01-15T10:30:00.000Z",
    "updatedAt": "2025-01-16T09:12:00.000Z"
  },
  "link": "https://app.confident-ai.com/project/<PROJECT-ID>/personas",
  "deprecated": false
}

Headers

  • CONFIDENT_API_KEYstringRequired

    The API key of your Confident AI project.

Path parameters

  • personaIdstringRequired

    The id of the persona.

Request body

  • namestring

    The name of the persona, unique within the project. Omit it to keep the current name.

  • characteristicsstring

    How this persona behaves in a conversation, as the simulator reads it on every user turn. The text replaces the stored one outright rather than being appended to, so send the whole description. Omit it to keep the current one.

Response

Update Persona succeeded.

  • successboolean

    Indicates if the request was successful.

  • dataobject

    A reusable character for the simulated user in a multi-turn conversation. Confident AI simulates conversations against your LLM app from multi-turn goldens, and a golden that names a persona has its user side played in character: the persona supplies who is talking, while the golden supplies what they want and when the conversation is done. Defining the character once here is what keeps 'a frustrated customer who types in lowercase' from being retyped on every row, and lets you compare runs where only the user changed.

    Show 5 propertiesHide 5 properties

    • idstring

      The id of the persona, generated by Confident AI.

    • namestring

      The name of the persona, unique within the project.

    • characteristicsstring

      How this persona behaves in a conversation, as the simulator reads it on every user turn.

    • createdAtstring

      The time the persona was created, as an ISO 8601 datetime.

    • updatedAtstring

      The time the persona was last changed, as an ISO 8601 datetime.

  • linkstring

    This is the URL of the resource on the Confident AI platform.

  • deprecatedboolean

    Indicates if this endpoint is deprecated.

Built byConfident AI