Skip to main content
PATCH
Update a person on an account's org chart

Authorizations

X-API-Key
string
header
required

Path Parameters

account_key
string
required

The account's key: its domain (acme.com), or its LinkedIn page (li-co:acme).

Required string length: 1 - 320
Pattern: ^(?:[^/.][^/]*|\.[^/.][^/]*|\.\.[^/]+)$
person_id
string<uuid>
required

Body

application/json

What a rep sets for one person on the chart; a field left out stays as it is.

hidden

Hide them from the chart, or show them.

hidden_reason

Why a rep hid a person from the chart (review AC-33). None: not said.

Available options:
left,
wrong_person,
not_relevant
manager_choice

What a rep said of a person's manager. None: nothing, the chart's own sources decide.

PERSON names a manager at the account; TOP says the person reports to nobody here.

Available options:
person,
top
manager_id
string<uuid> | null

Their manager's person id, with person.

role

The part a rep says a person plays in a deal. None: not known.

Available options:
champion,
budget_holder,
decision_maker,
influencer,
user,
blocker

Response

Successful Response

One person on the chart, the line drawn for them, and what reps set.

edited_at
string<date-time> | null
required
edited_by_user_id
string | null
required
hidden
boolean
required

Whether a rep hid them from the chart.

line
AccountChartLineReadSchema · object | null
required

The line drawn; None when no source gives one.

other_lines
AccountChartLineReadSchema · object[]
required

What weaker sources say, where they name a different manager.

person
AccountPersonReadSchema · object
required

One person at the account, once however many rows name them.

role
enum<string> | null
required

Their part in a deal, as a rep set it.

Available options:
champion,
budget_holder,
decision_maker,
influencer,
user,
blocker
role_set_at
string<date-time> | null
required

When the role was set.

role_set_by_user_id
string | null
required

Who set the role, when one is set.

hidden_reason
enum<string> | null

With hidden: why. left: they left the company; wrong_person: the row is not someone at this company; not_relevant: here, but not part of the deal. Null when shown, or when no reason was given.

Available options:
left,
wrong_person,
not_relevant