Sign in

v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-04-21149158448.6 KB
Agent Environment
personas

Get Persona

Get a single persona by ID.

Requires persona:read permission and team_id query parameter. The user's JWT must be scoped to that team.

get/v1/personas/{id}

Path parameters

idstring uuid required

Query parameters

team_idstring uuid nullable

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

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

Response

Successful Response

idstring uuid required
team_idstring uuid required
namestring required
descriptionstring nullable
rolestring required
role_descriptionstring nullable
knowledge_level'beginner' | 'intermediate' | 'advanced' | 'expert'

Knowledge level of the persona.

skill_level'novice' | 'competent' | 'proficient' | 'expert'

Skill level of the persona.

intent'benign' | 'curious' | 'adversarial' | 'malicious'

Intent type of the persona.

languagestring
is_presetboolean
preset_categorystring nullable
tagsstring[] nullable
icon_filenamestring nullable
created_atinteger required
updated_atinteger required
created_bystring uuid required