v1

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

Agent Environment

personas

Create From Preset

Create a new persona from a system preset.

Requires persona:write permission.

post/v1/personas/from-preset/{preset_id}

preset_idstring uuid required

name_overridestring nullable

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