Skip to main content
PATCH
Update person

Authorizations

Authorization
string
header
required

Access token issued by gs.service.id. Its access_identity claim carries team_sid, actor_sid and actor_type, and that team scope is authoritative.

Team-SID
string
header
required

Team scope for tokens that do not carry one. Ignored when the token already names a team.

Path Parameters

sid
string
required

Person sid (cr_pp_…).

Required string length: 18
Pattern: ^cr_pp_

Body

application/json

Request body of update_person.

full_name
string | null

New display name (1..255): a manual observation that outranks every source until reset; null records a manual none (no name shown). Never a column write.

Required string length: 1 - 255
avatar_url
string<uri> | null

New profile photo URL (max 2048): a manual observation; null records a manual none.

Maximum string length: 2048
ln_member_id
string | null

Identity edit - re-runs the duplicate flag (a collision flags this row, never a 409).

Maximum string length: 255
ln_id
string | null

Raw LinkedIn profile URN (ACoAA...), no spaces; identity edit, re-runs the duplicate flag.

Maximum string length: 255
Pattern: ^\S*$
sn_id
string | null

Raw Sales Navigator URN (ACwAA...), no spaces; identity edit, re-runs the duplicate flag.

Maximum string length: 255
Pattern: ^\S*$
recruiter_id
string | null

Raw Recruiter URN (AEMAA...), no spaces; identity edit, re-runs the duplicate flag.

Maximum string length: 255
Pattern: ^\S*$
ln_nickname
string | null

Vanity slug or profile URL (reduced to its axis on write); re-runs the duplicate flag.

Maximum string length: 255
Pattern: ^\S*$
work_email
string<email> | null

Identity edit - re-runs the duplicate flag (a collision flags this row, never a 409); stored lowercased.

personal_email
string<email> | null

Identity edit - re-runs the duplicate flag; stored lowercased.

work_phone_number
string | null

Plain string, E.164 preferred; identity edit on the E.164 twin, re-runs the duplicate flag.

Maximum string length: 255
personal_phone_number
string | null

Plain string, E.164 preferred; identity edit on the E.164 twin, re-runs the duplicate flag.

Maximum string length: 255
linkedin_status
enum<string>

Channel status override (need_enrichment | enrichment_failed | no_data | blocked | ok).

Available options:
need_enrichment,
enrichment_failed,
no_data,
blocked,
ok
email_status
enum<string> | null

need_search | no_data | bounced | ok; null = channel not initialized.

Available options:
need_search,
no_data,
bounced,
ok,
catch_all,
unverified
phone_status
enum<string> | null

need_search | no_data | ok; null = channel not initialized.

Available options:
need_search,
no_data,
ok
company_sid
string | null

Must exist; the person's company then resolves from the account. null unlinks the company.

Required string length: 18
Pattern: ^cr_co_
company_name
string | null

A manual observation of a name that is not an account, read when no company_sid links the row; null records a manual none.

Maximum string length: 255
company_ln_id
string | null

A manual observation of the company LinkedIn id, read when no company_sid links the row; null records a manual none.

Maximum string length: 255
tag_sids
string[] | null

Full-replace of the tag array.

Required string length: 18
Pattern: ^cr_tg_
external_refs
object | null

Free-form CRM sync map, full-replace; keys integration-defined, stored as-is.

Response

update success envelope.

success
enum<boolean>
required
Available options:
true
operation
enum<string>
required
Available options:
update
item
object
required
updated_fields
string[]
required
previous_values
object
required
meta
object
required
kept_fields
string[]

The fields this write did not change because the person's own value stands on them (stamped person); read the item for what landed.