Change Log
Org Chart v1.2.0
Released: 2026-03-11
Company API – Org Chart v1.2
A new version of the org chart endpoint is available:
GET https://api.theorg.com/v1.2/companies/org-chartChanges in v1.2.0:
- No unplaced section – The endpoint no longer supports the unplaced section. Only nodes in the org chart or board are returned.
- Section parameter – The
sectionquery parameter acceptsorgChartorboardand defaults toorgChart. - Leaner nodes –
linkedinUrlandworkEmailare no longer included in org chart nodes in the response. To get contact details and other fields, enrich nodes by theiridusing the Position API (e.g. by position id or by looking up the node id).
MCP Integration
Released: 2026-02-24
This release adds support for the Model Context Protocol (MCP):
- MCP Integration – New documentation section with Introduction and Get started for connecting Claude Desktop and Cursor to The Org’s data.
- MCP API – New endpoint for MCP over Streamable HTTP. See MCP API reference.
POST https://api.theorg.com/v1.1/mcpAuthentication uses the same API key (X-Api-Key header). Available tools: get_org_chart, get_manager, get_usage, find_positions. Credit costs match the existing Company API and Position API.
Org Chart v1.1.0
Released: 2025-10-27
Company API
This release introduces the following changes to the Company API:
GET https://api.theorg.com/v1.1/companies/org-chart-
The endpoint now returns all nodes associated with a company. The Org maintains a backlog of positions and jobs that are not yet placed in the company org chart, but are still associated with the company. Previously only placed positions and jobs were returned, now both positions and jobs are returned and a
sectionproperty is added to indicate whether these nodes are part of theorgChart,boardAndAdvisorsor whether they areunplaced. -
A parameter has been added to the endpoint to filter the results by section.
GET https://api.theorg.com/v1.1/companies/org-chart?domain=theorg.com§ion=orgChartParameter Type Description Required sectionquery Section to filter by falseThe section can be one of the following:
orgChartboardunplaced
Migrating from v1 to v1.1
Simply include the section parameter set to orgChart to get the same results as before, the section property can be ingnored in this case.