Skip to main content
POST
Create a persona

Authorizations

X-API-Key
string
header
required

Your brk_live_ API key.

Body

application/json
name
string
required

Display name. The slug is derived from it (unique per account).

Example:

"Marketing leaders"

definition
string
required

Plain-language criteria the persona LLM judges each roster member against. Describe who to KEEP, including any exclusions.

Example:

"Heads of marketing or growth with budget authority — not junior or freelance."

make_default
boolean
default:false

Make this the account's default persona.

Response

Successful Response

A saved target audience. definition is plain-language criteria our LLM judges each decision maker against (roles, seniority, function, exclusions) — not a keyword filter. Reference it on POST /v1/jobs by slug to keep only the matches; it never changes the price.

slug
string
required

Stable id, unique per account — pass this as the persona on POST /v1/jobs.

Example:

"marketing-leaders"

name
string
required

Display name.

Example:

"Marketing leaders"

definition
string
required

Plain-language criteria the persona LLM judges each roster member against.

Example:

"Heads of marketing or growth with budget authority — not junior or freelance."

is_default
boolean
default:false

Whether this is the account's default persona.

is_system
boolean
default:false

Immutable system persona; it cannot be edited or deleted.

created_at
string | null

ISO 8601 UTC.

Example:

"2026-07-20T09:00:00Z"