v1

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

Agent Environment

personas

Update Persona

Update an existing persona.

Supports partial updates - only provided fields will be updated. Requires persona:write permission.

put/v1/personas/{id}

idstring uuid required

namestring nullable

descriptionstring nullable

rolestring nullable

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 nullable

is_presetboolean nullable

preset_categorystring nullable

tagsstring[] nullable

icon_filenamestring 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