Skip to main content
PUT
Update a persona
Omitted fields keep their current value, and so does each side of an included/excluded filter pair: sending job_titles alone keeps excluded_job_titles, and sending excluded_job_titles alone keeps job_titles. The same applies to included_industries/excluded_industries and included_locations/excluded_locations. Send [] to clear a list. A persona must keep at least one included job title. An update that leaves it with none is rejected with 422 and "At least one job_title is required".

Authorizations

X-API-KEY
string
header
required

Your API key

Path Parameters

uuid
string<uuid>
required

UUID of the persona

Body

application/json

Every field is optional; omitted fields keep their current value.

name
string

New name. A blank value keeps the current name

Example:

"VP Engineering France"

description
string | null

New description. Sending the key (even null) replaces the current value

job_titles
string[]

Job titles to include. Replaces the current list; omit it to keep it. The persona must keep at least one included job title

Example:
excluded_job_titles
string[]

Job titles to exclude. Replaces the current list; omit it to keep it, send [] to clear it

Example:
ai_expand_job_titles
boolean
default:false

When true, the titles in job_titles are expanded with AI into variations (other seniority levels and languages, based on your agent language preferences). Suggested exclusions are added to excluded_job_titles.

included_industries
string[]

LinkedIn industry IDs to include. Replaces the current list; omit it to keep it, send [] to clear it

Example:
excluded_industries
string[]

LinkedIn industry IDs to exclude. Replaces the current list; omit it to keep it, send [] to clear it

Example:
included_locations
string[]

Location IDs to include. Replaces the current list; omit it to keep it, send [] to clear it

Example:
excluded_locations
string[]

Location IDs to exclude. Replaces the current list; omit it to keep it, send [] to clear it

Example:
company_size
enum<string>[]

Company headcount ranges. Replaces the current list; omit it to keep it. The LinkedIn size codes A–I are also accepted for older integrations, and are returned as sent.

Available options:
Self-employed,
1-10,
11-50,
51-200,
201-500,
501-1000,
1001-5000,
5001-10000,
10001+
Example:

Response

Persona updated

uuid
string<uuid>

Unique identifier of the persona

Example:

"8e1dcba0-f0bb-4071-99fc-f18ba6559ccc"

name
string

Name of the persona

Example:

"VP Engineering France"

description
string | null

Free-text description

Example:

"Engineering leaders at French SaaS scale-ups"

included_job_titles
string[]

Job titles to include

Example:
excluded_job_titles
string[]

Job titles to exclude

Example:
included_industries
string[]

LinkedIn industry IDs to include

Example:
excluded_industries
string[]

LinkedIn industry IDs to exclude

Example:
included_locations
string[]

Location IDs to include

Example:
excluded_locations
string[]

Location IDs to exclude

Example:
company_size
string[]

Company size ranges

Example:
sales_nav_url
string | null

Sales Navigator search URL derived from the filters

Example:

"https://www.linkedin.com/sales/search/people?query=..."

created_at
string<date-time>

The creation date of the persona

Example:

"2025-01-03T17:35:33.073Z"

updated_at
string<date-time>

The last modified date of the persona

Example:

"2025-01-03T17:35:33.073Z"