Skip to main content
GET
Get Persona

Path Parameters

id
string<uuid>
required

Query Parameters

team_id
string<uuid> | null

Team scope (required); must match a team the user has access to

Response

Successful Response

Domain model for Persona archetype.

id
string<uuid>
required
team_id
string<uuid>
required
name
string
required
role
string
required
created_at
integer
required
updated_at
integer
required
created_by
string<uuid>
required
description
string | null
role_description
string | null
knowledge_level
enum<string>
default:intermediate

Knowledge level of the persona.

Available options:
beginner,
intermediate,
advanced,
expert
skill_level
enum<string>
default:competent

Skill level of the persona.

Available options:
novice,
competent,
proficient,
expert
intent
enum<string>
default:benign

Intent type of the persona.

Available options:
benign,
curious,
adversarial,
malicious
language
string
default:en
access_permissions
PersonaAccessPermissions · object

Access permissions for persona - used for test scenario definition.

NOTE: This is NOT for actual RBAC enforcement - it defines expected access for generating test cases to verify agent access control.

is_preset
boolean
default:false
preset_category
string | null
tags
string[] | null
icon_filename
string | null
Last modified on April 21, 2026