Create Persona — API

Create a workspace-level persona for voice or text simulation. Set gender, age group, personality, communication style, and tone. Returns the new persona object.

POST https://api.futureagi.com/simulate/api/personas/

Authentication

X-Api-Key API Key Required

Your Future AGI API key used to authenticate requests. You can find and manage your API keys in the Dashboard under Settings.

X-Secret-Key Secret Key Required

Your Future AGI secret key, used alongside the API key for request authentication. This is generated when you create an API key in the Dashboard.

Request body

name string Required

Name for the persona. Must be unique within the workspace (case-insensitive). Max 255 characters.

description string Required

Non-empty description of the persona’s role and characteristics.

simulationType string Optional

Values: voice, text. Defaults to voice.

gender array of string Optional

Values: male, female.

ageGroup array of string Optional

Values: 18-25, 25-32, 32-40, 40-50, 50-60, 60+.

location array of string Optional

Values: United States, Canada, United Kingdom, Australia, India.

profession array of string Optional

Values: Student, Teacher, Engineer, Doctor, Nurse, Business Owner, Manager, Sales Representative, Customer Service, Technician, Consultant, Accountant, Marketing Professional, Retired, Homemaker, Freelancer, Other.

personality array of string Optional

Values: Friendly and cooperative, Professional and formal, Cautious and skeptical, Impatient and direct, Detail-oriented, Easy-going, Anxious, Confident, Analytical, Emotional, Reserved, Talkative.

communicationStyle array of string Optional

Values: Direct and concise, Detailed and elaborate, Casual and friendly, Formal and polite, Technical, Simple and clear, Questioning, Assertive, Passive, Collaborative.

accent array of string Optional

Values: American, Australian, Indian, Canadian, Neutral. Voice simulation only.

multilingual boolean Optional

Enables multi-language support. Requires language when true. Defaults to false.

language array of string Optional

Values: English, Hindi. Required when multilingual is true.

conversationSpeed array of string Optional

Speech pace multipliers. Values: 0.5, 0.75, 1.0, 1.25, 1.5. Voice simulation only.

backgroundSound boolean Optional

Add ambient noise during voice simulations.

finishedSpeakingSensitivity array of integer Optional

End-of-speech sensitivity, 1–10. Voice simulation only.

interruptSensitivity array of integer Optional

Interruptibility, 1–10. Voice simulation only.

keywords array of string Optional

Searchable tags for filtering personas.

customProperties object Optional

Key-value metadata. Keys and values must be non-empty strings.

additionalInstruction string Optional

Free-form behavioral instructions passed to the simulation engine.

tone string Optional

Values: formal, casual, neutral. Defaults to casual.

punctuation string Optional

Values: clean, minimal, expressive, erratic. Defaults to clean.

slangUsage string Optional

Values: none, light, moderate, heavy. Defaults to light.

typosFrequency string Optional

Values: none, rare, occasional, frequent. Defaults to rare.

regionalMix string Optional

Values: none, light, moderate, heavy. Defaults to light.

emojiUsage string Optional

Values: never, light, regular, heavy. Defaults to light.

verbosity string Optional

Values: brief, balanced, detailed. Defaults to balanced.

Response

201 Created
status string
"success" on creation.
result object
The created persona object, including id, persona_type (workspace), all submitted attributes, and created_at / updated_at timestamps.

Errors

400 Bad Request Optional

Missing required fields, duplicate name, or invalid field values.

401 Unauthorized Optional

Invalid or missing API credentials.

500 Internal Server Error Optional

Unexpected server error.

GET /
Authentication
REQUEST 
 
 
  
 
 RESPONSE