persona_get

Fetches a single Persona by the pair that addresses it: its Brand’s slug and its own.

A Persona is an audience archetype — who a brand is talking to. It is the counterpart to the Brand’s own sections, which say who it is talking as. Discover a brand’s personas with brand_get; there is no separate list tool, because the brand bundle already carries them.

Input

Field	Type	Required	Description
brand_name	string	yes	The slug of the brand that owns the persona.
persona_name	string	yes	The persona slug. Unique within its brand, so it must be paired with brand_name.

Output

{ persona }, carrying slug, name, description, revision, the age range, and four context sections:

Section	What belongs in it
profile	Who they are: life stage, situation, role, context
motivations	What they want: jobs to be done, triggers, outcomes
frictions	What stops them: objections, doubts, perceived risk
language	The words they use for the problem — their verbatims

Each section is free-form markdown and independently optional — one you haven’t written is null, which is normal rather than an error.

ageMin and ageMax are independently nullable: ageMin alone means “and older”, ageMax alone means “and younger”, and both null means the persona is not defined by age at all.

Example

“Write three ad headlines for Acme Running, aimed at Marathon Maya.”

persona_get({ brand_name: 'acme-running', persona_name: 'marathon-maya' });
// → { persona: { slug: 'marathon-maya', ageMin: 30, ageMax: 44,
//                frictions: 'Thinks carbon plates are a gimmick…', … } }

The agent reads frictions and language alongside the brand’s voice, so the headline answers a real objection in words the reader would use.

Requires the brand:read scope — a persona is part of its brand’s context, not a separate permission.