List personas

Returns a paginated list of system and workspace personas.

GET 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.

Query parameters

type string Optional

Values: prebuilt, custom.

search string Optional

Case-insensitive search across name, description, and keywords.

simulation_type string Optional

Values: voice, text.

limit integer Optional

Results per page. Defaults to 10.

page integer Optional

Page number, starting from 1. Defaults to 1.

Response

200 OK
count integer
Total matching personas across all pages.
next string
URL of the next page, or null.
previous string
URL of the previous page, or null.
total_pages integer
Total number of pages.
current_page integer
Current page number.
results array of object

Array of persona objects.

id string
UUID of the persona.
name string
Persona name.
description string
Persona description.
persona_type string
Origin type: system or workspace.
persona_type_display string
Display label, e.g. Prebuilt or Custom.
gender array
Gender attributes.
age_group array
Age group ranges.
occupation array
Occupation descriptors.
location array
Location descriptors.
personality array
Personality traits.
communication_style array
Communication style descriptors.
simulation_type string
voice or text.
is_default boolean
Whether this is a default persona.
created_at string
ISO 8601 creation timestamp.
updated_at string
ISO 8601 last-modified timestamp.

Errors

401 Unauthorized Optional

Invalid or missing API credentials.

500 Internal Server Error Optional

Unexpected server error.

GET /
Authentication
REQUEST 
 
 
  
 
 RESPONSE