Skip to main content
PATCH
Update a persona

Authorizations

X-API-Key
string
header
required

Your brk_live_ API key.

Path Parameters

slug
string
required

Body

application/json
name
string | null

New display name (slug is not changed).

definition
string | null

New criteria text.

make_default
boolean | null

Set true to make this the 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"