Org Chart

Chart Node

A chart node is the building block of an org chart represention a position in the org chart and a relation to other nodes.

The chart node will always contain an id, a section, and a managerId. If the managerId is empty the node i at the top of the org chart and has no direct managers.

The chart node properties are shaped by the contents of the node. Currently nodes may contain the following:

A Position - an individual person employed at the company
A Job Post - an open position
A Co-manager group - a collection of two or more chart nodes
Nothing - it’s possible for a node to not contain anything, in this case it represents only the structural element of the node.

Position

Field	Type	Description	Nullable
`id`	string	Unique identifier for the chart node	`false`
`positionId`	string	Unique identifier for the position	`false`
`fullName`	string	Full name of the person in the position	`false`
`title`	string	Job title/role of the position	`false`
`workEmail`	string	The professional email of this person	`true`
`linkedInUrl`	string	URL to the person’s LinkedIn profile	`true`
`managerId`	string	ID of the managing chart node	`true`
`section`	string	Section the node is part of	`false`

💡

When using the org chart endpoint v1.2, position nodes in the response do not include linkedinUrl or workEmail. Enrich nodes by their id using the Position API to retrieve contact details and other fields.

Job Post

Field	Type	Description	Nullable
`id`	string	Unique identifier for the chart node	`false`
`jobId`	string	Unique identifier for the job posting	`false`
`jobTitle`	string	Title of the open position	`false`
`managerId`	string	ID of the managing chart node	`true`
`section`	string	Section the node is part of	`false`

Co-manager Group

When requesting the full org chart the members property will be a list of strings representing node ids that can be looked up in the remainder of the response.

Field	Type	Description	Nullable
`id`	string	Unique identifier for the chart node	`false`
`name`	string	Display name of the co-manager group	`false`
`members`	string[]	List of chart node IDs that are part of this group	`false`
`managerId`	string	ID of the managing chart node	`true`
`section`	string	Section the node is part of	`false`

When requesting the find manager api the members property have the ids expanded and will be a list of nodes.

Field	Type	Description	Nullable
`id`	string	Unique identifier for the chart node	`false`
`name`	string	Display name of the co-manager group	`false`
`members`	ChartNode[]	List of expanded chart nodes that are part of this group	`false`
`managerId`	string	ID of the managing chart node
`section`	string	Section the node is part of

💡

Note that co-manager nodes are not allowed to contain other co-manager nodes and will never recurse.

Empty Node

Field	Type	Description	Nullable
`id`	string	Unique identifier for the chart node	`false`
`managerId`	string	ID of the managing chart node	`true`
`section`	string	Section the node is part of	`false`

Example


[
  {
    "id": "g-12403",
    "name": "Co-CEOs",
    "members": ["p-4449", "p-4448"],
    "managerId": null,
    "nodeType": "coManager",
    "section": "orgChart"
  },
  {
    "id": "p-4449",
    "positionId": 4449,
    "fullName": "Ted Sarandos",
    "title": "Co-CEO",
    "linkedInUrl": "https://www.linkedin.com/in/tedsarandos",
    "managerId": null,
    "nodeType": "position",
    "section": "orgChart"
  },
  {
    "id": "p-4448",
    "positionId": 4448,
    "fullName": "Greg Peters",
    "title": "Co-CEO",
    "linkedInUrl": "https://linkedin.com/in/petersgreg",
    "managerId": null,
    "nodeType": "position",
    "section": "orgChart"
  }
]

Section

The section property is added to the chart node to indicate whether the node is part of the orgChart, boardAndAdvisors or whether they are unplaced.

Value	Description
`orgChart`	The node is part of the org chart
`board`	The node is part of the board and advisors
`unplaced`	The node is not part of the org chart