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

# POST /simulate/api/personas/

`POST /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`

Create a new workspace-level persona

## Request body

- PersonaCreate
  - `name` string, required
  - `description` string, required
  - `gender` string[], nullable
  - `age_group` string[], nullable
  - `location` string[], nullable
  - `profession` string[], nullable
  - `personality` string[], nullable
  - `communication_style` string[], nullable
  - `accent` string[], nullable
  - `multilingual` boolean
  - `language` string[], nullable
  - `conversation_speed` string[], nullable
  - `background_sound` boolean, nullable
  - `finished_speaking_sensitivity` string[], nullable
  - `interrupt_sensitivity` string[], nullable
  - `keywords` string[], nullable
  - `custom_properties` object, nullable
  - `additional_instruction` string, nullable
  - `simulation_type` string, nullable
  - `tone` string, nullable
  - `punctuation` string, nullable
  - `slang_usage` string, nullable
  - `typos_frequency` string, nullable
  - `regional_mix` string, nullable
  - `emoji_usage` string, nullable
  - `verbosity` string, nullable

## Response `201`

Created

- PersonaCreate
  - `name` string, required
  - `description` string, required
  - `gender` string[], nullable
  - `age_group` string[], nullable
  - `location` string[], nullable
  - `profession` string[], nullable
  - `personality` string[], nullable
  - `communication_style` string[], nullable
  - `accent` string[], nullable
  - `multilingual` boolean
  - `language` string[], nullable
  - `conversation_speed` string[], nullable
  - `background_sound` boolean, nullable
  - `finished_speaking_sensitivity` string[], nullable
  - `interrupt_sensitivity` string[], nullable
  - `keywords` string[], nullable
  - `custom_properties` object, nullable
  - `additional_instruction` string, nullable
  - `simulation_type` string, nullable
  - `tone` string, nullable
  - `punctuation` string, nullable
  - `slang_usage` string, nullable
  - `typos_frequency` string, nullable
  - `regional_mix` string, nullable
  - `emoji_usage` string, nullable
  - `verbosity` string, nullable

## 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)