Update persona

Partially updates a workspace-level persona. System personas cannot be modified.

PATCH https://api.futureagi.com/simulate/api/personas/{persona_id}/

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.

Path parameters

persona_id UUID Required

The persona ID. Must be a workspace-level persona; system personas cannot be modified.

Request body

Only fields included in the request are updated. Array fields replace the existing list entirely.

name string Optional

New name. Must be unique within the workspace (case-insensitive). Max 255 characters.

description string Optional

Non-empty description.

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.

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.

multilingual boolean Optional

Requires language when true.

language array of string Optional

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

keywords array of string Optional

Searchable tags.

customProperties object Optional

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

additionalInstruction string Optional

Free-form behavioral instructions.

tone string Optional

Values: formal, casual, neutral.

punctuation string Optional

Values: clean, minimal, expressive, erratic.

slangUsage string Optional

Values: none, light, moderate, heavy.

typosFrequency string Optional

Values: none, rare, occasional, frequent.

regionalMix string Optional

Values: none, light, moderate, heavy.

emojiUsage string Optional

Values: never, light, regular, heavy.

verbosity string Optional

Values: brief, balanced, detailed.

Response

200 OK
status string
"success" on update.
result object
The updated persona object with all current attribute values.

Errors

400 Bad Request Optional

Invalid field values, duplicate name, or missing language when multilingual is true.

401 Unauthorized Optional

Invalid or missing API credentials.

403 Forbidden Optional

Persona is a system-level persona and cannot be modified.

404 Not Found Optional

Persona not found.

500 Internal Server Error Optional

Unexpected server error.

GET /
Authentication
REQUEST 
 
 
  
 
 RESPONSE