---
title: "GET /simulate/api/personas/"
method: GET
path: "/simulate/api/personas/"
tags: ["simulate"]
---

# GET /simulate/api/personas/

`GET /simulate/api/personas/`

## Request

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

List personas with pagination

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

OK

- object
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` PersonaList[], required
    - `id` string, uuid
    - `persona_type` 'system' | 'workspace': Type of persona (system or workspace-level)
    - `persona_type_display` string
    - `name` string: 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
    - `simulation_type` string
    - `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
- `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)