Skip to Content

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-chart

Changes in v1.2.0:

  1. No unplaced section – The endpoint no longer supports the unplaced section. Only nodes in the org chart or board are returned.
  2. Section parameter – The section query parameter accepts orgChart or board and defaults to orgChart.
  3. Leaner nodeslinkedinUrl and workEmail are no longer included in org chart nodes in the response. To get contact details and other fields, enrich nodes by their id using 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/mcp

Authentication 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
  1. 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 section property is added to indicate whether these nodes are part of the orgChart, boardAndAdvisors or whether they are unplaced.

  2. 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&section=orgChart
    ParameterTypeDescriptionRequired
    sectionquerySection to filter byfalse

    The section can be one of the following:

    • orgChart
    • board
    • unplaced

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.

Last updated on