v29

latestOpenAPI 3.1.0raw.githubusercontent.com2026-03-233765161.7 KB
v1 personas

Get all personas for the organization

Get all personas accessible to the caller.

This endpoint:
- Returns **all** personas across the organization (personas are shared org-wide)
- All users in the org can see all org personas
- Includes persona metadata (name, description, creation date)

**Authentication**: Requires valid API key or JWT token
get/v1/personas

Response

Successful Response

total_countinteger required

Total number of personas

user_idstring nullable

User ID (set when filtering by user)

org_idstring nullable

Organization ID (set when returning org-wide personas)

Example response

{
  "personas": [
    {
      "created_at": "2023-01-01T00:00:00Z",
      "description": "A persona focused on professional writing",
      "name": "Professional Writer",
      "persona_id": "123e4567-e89b-12d3-a456-426614174000",
      "user_email": "john@example.com",
      "user_id": "456e7890-e89b-12d3-a456-426614174001",
      "user_name": "John Doe"
    }
  ],
  "total_count": 1,
  "user_id": "456e7890-e89b-12d3-a456-426614174001"
}