v1

latestOpenAPI 3.1.02026-07-2295105298.6 KB

Basics

Get Personas

Returns all personas for a specific website, sorted by name, with the number of non-deleted prompts each persona is assigned to. Use the returned IDs to resolve persona_id values returned by other endpoints and tools to persona names and descriptions.

get/api/v1/personas

Query parameters

website_idstring uuid required

The ID of the website to retrieve personas for

Response

Successful response with list of personas

Example response

{
  "personas": [
    {
      "id": "323e4567-e89b-12d3-a456-426614174222",
      "name": "Marketing Lead",
      "description": "Owns the brand narrative at a mid-market SaaS company",
      "prompt_count": 12
    }
  ]
}