---
title: "PATCH /simulate/api/personas/{id}/"
method: PATCH
path: "/simulate/api/personas/{id}/"
tags: ["simulate"]
---

# PATCH /simulate/api/personas/{id}/

`PATCH /simulate/api/personas/{id}/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/simulate/api/personas/{id}/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

ViewSet for managing Personas.

## Request body

- Persona
  - `id` string, uuid
  - `persona_type` 'system' | 'workspace': Type of persona (system or workspace-level)
  - `persona_type_display` string
  - `name` string, required: Name of the persona
  - `description` string, nullable: Description of the persona
  - `gender` object, nullable: List of genders for the persona (e.g., ['male'], ['female'])
  - `age_group` object, nullable: List of age groups for the persona (e.g., ['18-25'], ['25-32'])
  - `occupation` object, nullable: List of occupations/professions for the persona (e.g., ['Engineer'], ['Teacher'])
  - `location` object, nullable: List of locations for the persona (e.g., ['United States'], ['Canada'])
  - `personality` object, nullable: List of personality types for the persona (e.g., ['Friendly and cooperative'])
  - `communication_style` object, nullable: List of communication styles for the persona (e.g., ['Direct and concise'])
  - `multilingual` boolean, nullable: Whether the persona supports multiple languages
  - `languages` object, nullable: List of languages the persona speaks (e.g., ['English', 'Hindi'])
  - `accent` object, nullable: List of accents for the persona (e.g., ['American'], ['Australian'])
  - `conversation_speed` object, nullable: List of conversation speeds (e.g., ['1.0'], ['1.25'])
  - `background_sound` boolean, nullable: Whether background sound is enabled (null=not specified, True/False for enabled/disabled)
  - `finished_speaking_sensitivity` object, nullable: List of sensitivities for detecting when persona finished speaking (e.g., ['5'], ['6'])
  - `interrupt_sensitivity` object, nullable: List of sensitivities for allowing interruptions (e.g., ['5'], ['6'])
  - `keywords` object, nullable: List of keywords/tags describing the persona (e.g., ['Knowledgeable', 'Patient', 'Helpful'])
  - `metadata` object, nullable: Additional metadata for the persona (speech clarity, base emotion, etc.)
  - `additional_instruction` string, nullable: Additional instructions for how this persona should behave
  - `is_default` boolean, nullable: Whether this is a default/recommended persona
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `profession` string[], nullable
  - `language` string[], nullable
  - `custom_properties` object, nullable
  - `simulation_type` 'voice' | 'text': Type of simulation for the persona
  - `punctuation` 'clean' | 'minimal' | 'expressive' | 'erratic', nullable: Punctuation style for the persona
  - `slang_usage` 'none' | 'moderate' | 'heavy' | 'light', nullable: Slang usage for the persona
  - `typos_frequency` 'none' | 'rare' | 'occasional' | 'frequent', nullable: Typos frequency for the persona
  - `regional_mix` 'none' | 'moderate' | 'heavy' | 'light', nullable: Regional mix for the persona
  - `emoji_usage` 'never' | 'light' | 'regular' | 'heavy', nullable: Emoji usage for the persona
  - `tone` 'formal' | 'casual' | 'neutral', nullable: Tone for the persona
  - `verbosity` 'brief' | 'balanced' | 'detailed', nullable: Verbosity for the persona

## Response `200`

OK

- Persona
  - `id` string, uuid
  - `persona_type` 'system' | 'workspace': Type of persona (system or workspace-level)
  - `persona_type_display` string
  - `name` string, required: Name of the persona
  - `description` string, nullable: Description of the persona
  - `gender` object, nullable: List of genders for the persona (e.g., ['male'], ['female'])
  - `age_group` object, nullable: List of age groups for the persona (e.g., ['18-25'], ['25-32'])
  - `occupation` object, nullable: List of occupations/professions for the persona (e.g., ['Engineer'], ['Teacher'])
  - `location` object, nullable: List of locations for the persona (e.g., ['United States'], ['Canada'])
  - `personality` object, nullable: List of personality types for the persona (e.g., ['Friendly and cooperative'])
  - `communication_style` object, nullable: List of communication styles for the persona (e.g., ['Direct and concise'])
  - `multilingual` boolean, nullable: Whether the persona supports multiple languages
  - `languages` object, nullable: List of languages the persona speaks (e.g., ['English', 'Hindi'])
  - `accent` object, nullable: List of accents for the persona (e.g., ['American'], ['Australian'])
  - `conversation_speed` object, nullable: List of conversation speeds (e.g., ['1.0'], ['1.25'])
  - `background_sound` boolean, nullable: Whether background sound is enabled (null=not specified, True/False for enabled/disabled)
  - `finished_speaking_sensitivity` object, nullable: List of sensitivities for detecting when persona finished speaking (e.g., ['5'], ['6'])
  - `interrupt_sensitivity` object, nullable: List of sensitivities for allowing interruptions (e.g., ['5'], ['6'])
  - `keywords` object, nullable: List of keywords/tags describing the persona (e.g., ['Knowledgeable', 'Patient', 'Helpful'])
  - `metadata` object, nullable: Additional metadata for the persona (speech clarity, base emotion, etc.)
  - `additional_instruction` string, nullable: Additional instructions for how this persona should behave
  - `is_default` boolean, nullable: Whether this is a default/recommended persona
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `profession` string[], nullable
  - `language` string[], nullable
  - `custom_properties` object, nullable
  - `simulation_type` 'voice' | 'text': Type of simulation for the persona
  - `punctuation` 'clean' | 'minimal' | 'expressive' | 'erratic', nullable: Punctuation style for the persona
  - `slang_usage` 'none' | 'moderate' | 'heavy' | 'light', nullable: Slang usage for the persona
  - `typos_frequency` 'none' | 'rare' | 'occasional' | 'frequent', nullable: Typos frequency for the persona
  - `regional_mix` 'none' | 'moderate' | 'heavy' | 'light', nullable: Regional mix for the persona
  - `emoji_usage` 'never' | 'light' | 'regular' | 'heavy', nullable: Emoji usage for the persona
  - `tone` 'formal' | 'casual' | 'neutral', nullable: Tone for the persona
  - `verbosity` 'brief' | 'balanced' | 'detailed', nullable: Verbosity for the persona

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error
- `default`: Default error response

---

[API](https://skmtc.dev/futureagi/apis/future-agi-management-api.md) · [All operations](https://skmtc.dev/futureagi/apis/future-agi-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futureagi/apis/future-agi-management-api/revisions/c8684118e142?raw)