Personas
List available personas
Returns all personas accessible to the authenticated user. This includes base/global personas (available to everyone) and custom personas created within the user’s workspaces. The prompt field is excluded from responses for IP protection.
Use the returned id as the persona_id parameter in chat completions to inject persona intelligence into conversations.
GET
/
personas
curl https://app.mavera.io/api/v1/personas \
-H "Authorization: Bearer mvra_live_your_key_here"{
"object": "list",
"data": [
{
"id": "clx1abc2d0001abcdef123456",
"object": "persona",
"name": "Gen Z Consumer",
"category": "Generational",
"description": "Digital-native consumer aged 18-25 with strong social media influence.",
"is_custom": false,
"is_expert": false,
"created_at": 1706140800
},
{
"id": "clx2xyz9e0002abcdef789012",
"object": "persona",
"name": "SaaS CMO",
"category": "IndustrySpecific",
"description": "Chief Marketing Officer at a B2B SaaS company with $10M+ ARR.",
"is_custom": true,
"is_expert": true,
"created_at": 1706227200
}
]
}{
"error": {
"message": "Invalid API key.",
"type": "authentication_error",
"code": "invalid_api_key",
"param": null
}
}{
"error": {
"message": "Rate limit exceeded. Please retry after 30 seconds.",
"type": "rate_limit_error",
"code": "rate_limit_exceeded",
"param": null
}
}{
"error": {
"message": "An internal error occurred. Please try again later.",
"type": "api_error",
"code": "internal_error",
"param": null
}
}Authorizations
API key prefixed with mvra_live_. Create keys at Settings > Developer > API Keys.
Query Parameters
Filter by custom personas only
Filter by category
Search by name or description
Maximum number of results (default 50, max 100)
Required range:
1 <= x <= 100Cursor for pagination
Response
A list of personas accessible to the authenticated user.
⌘I
curl https://app.mavera.io/api/v1/personas \
-H "Authorization: Bearer mvra_live_your_key_here"{
"object": "list",
"data": [
{
"id": "clx1abc2d0001abcdef123456",
"object": "persona",
"name": "Gen Z Consumer",
"category": "Generational",
"description": "Digital-native consumer aged 18-25 with strong social media influence.",
"is_custom": false,
"is_expert": false,
"created_at": 1706140800
},
{
"id": "clx2xyz9e0002abcdef789012",
"object": "persona",
"name": "SaaS CMO",
"category": "IndustrySpecific",
"description": "Chief Marketing Officer at a B2B SaaS company with $10M+ ARR.",
"is_custom": true,
"is_expert": true,
"created_at": 1706227200
}
]
}{
"error": {
"message": "Invalid API key.",
"type": "authentication_error",
"code": "invalid_api_key",
"param": null
}
}{
"error": {
"message": "Rate limit exceeded. Please retry after 30 seconds.",
"type": "rate_limit_error",
"code": "rate_limit_exceeded",
"param": null
}
}{
"error": {
"message": "An internal error occurred. Please try again later.",
"type": "api_error",
"code": "internal_error",
"param": null
}
}