Skip to main content
PATCH
/
personas
/
{id}
cURL
curl -X PATCH https://app.mavera.io/api/v1/personas/YOUR_PERSONA_ID \
  -H "Authorization: Bearer mvra_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Persona Name",
    "goals": ["New goal 1", "New goal 2"],
    "pains": ["Updated pain point"]
  }'
{
  "id": "<string>",
  "object": "custom_persona",
  "name": "<string>",
  "category": "<string>",
  "description": "<string>",
  "pipeline_type": "north_star",
  "type": "B2B",
  "is_custom": true,
  "created_at": 123,
  "credits_charged": 300,
  "details": {
    "pipeline_type": "<string>",
    "persona_type": "<string>",
    "primary_use_case": "<string>",
    "buying_stage": "<string>",
    "decision_role": "<string>",
    "role_segment": [
      "<string>"
    ],
    "primary_objectives": [
      "<string>"
    ],
    "mcda_weights": {},
    "goals": [
      "<string>"
    ],
    "pains": [
      "<string>"
    ],
    "triggers": [
      "<string>"
    ],
    "channels": [
      "<string>"
    ],
    "proof_types": [
      "<string>"
    ],
    "alternatives": [
      "<string>"
    ],
    "win_factors": [
      "<string>"
    ],
    "objections": [
      "<string>"
    ],
    "values": [
      "<string>"
    ],
    "proof_preferences": [
      "<string>"
    ],
    "brand_voice_fit": "<string>",
    "reading_level": "<string>",
    "tone_guardrails": [
      "<string>"
    ],
    "role_title": "<string>",
    "seniority": "<string>",
    "industry": "<string>",
    "company_size": "<string>",
    "tech_stack": [
      "<string>"
    ],
    "budget_authority": "<string>",
    "procurement_constraints": [
      "<string>"
    ],
    "committee_mapping": [
      "<string>"
    ],
    "life_stage": "<string>",
    "age_band": "<string>",
    "income_band": "<string>",
    "household_context": [
      "<string>"
    ],
    "lifestyle_affinities": [
      "<string>"
    ],
    "purchase_cadence": "<string>",
    "key_differentiators": [
      "<string>"
    ],
    "regulatory_context": [
      "<string>"
    ],
    "is_localized": true,
    "locale_scope": "<string>",
    "locale_value": "<string>",
    "local_channels": [
      "<string>"
    ],
    "local_objections": [
      "<string>"
    ],
    "local_keywords": [
      "<string>"
    ],
    "price_sensitivity_delta": 123,
    "purpose_packs_enabled": {},
    "acquisition_config": {},
    "pmm_config": {},
    "content_config": {},
    "sales_config": {},
    "research_config": {}
  },
  "ai_generated": {
    "confidence": 123,
    "rationale": "<string>"
  }
}

Authorizations

Authorization
string
header
required

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

Path Parameters

id
string
required

The persona ID.

Body

application/json

Update an existing custom persona. All fields are optional - only include fields you want to change.

name
string
Required string length: 2 - 100
description
string
goals
string[]
pains
string[]
triggers
string[]
channels
string[]
objections
string[]
values
string[]
proof_preferences
string[]
tone_guardrails
string[]
alternatives
string[]
win_factors
string[]
role_title
string
seniority
string
industry
string
company_size
string
tech_stack
string[]
budget_authority
string
procurement_constraints
string[]
life_stage
string
age_band
string
income_band
string
household_context
string[]
lifestyle_affinities
string[]
purchase_cadence
string
key_differentiators
string[]
regulatory_context
string[]

Response

Persona updated 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