v1

latestOpenAPI 3.1.0raw.githubusercontent.com2026-04-21149158448.6 KB

Agent Environment

personas

Create Persona

Create a new persona.

Requires persona:write permission for the team_id in the request body.

post/v1/personas/

idstring uuid nullable

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

Successful Response

idstring uuid required