Skip to main content
POST
cURL (Intermediate)

Authorizations

Authorization
string
header
required

API key prefixed with mvra_live_. Create keys at Settings > Developer > API Keys.

Body

application/json

Create a custom persona using one of three pipeline types. Each pipeline has different required fields - see the individual schemas for details.

pipeline_type
enum<string>
required

Must be 'north_star' for this pipeline.

Available options:
north_star
Example:

"north_star"

suggestion
object
required

REQUIRED: The selected suggestion from /personas/suggestions endpoint.

business_description
string

Original business description (optional, for context).

target_customers
string[]

Original target customers (optional).

sources
object[]

Optional sources for additional context.

Response

Custom persona created successfully.

id
string

Unique persona ID.

object
enum<string>
Available options:
custom_persona
Example:

"custom_persona"

name
string
category
string
description
string
pipeline_type
enum<string>
Available options:
north_star,
intermediate,
advanced
type
enum<string> | null
Available options:
B2B,
B2C
is_custom
boolean
Example:

true

created_at
integer

Unix timestamp.

credits_charged
integer

Credits charged for creation.

Example:

300

details
object

Detailed custom persona fields.

ai_generated
object | null