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`

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