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>",
  "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