{"article":{"id":35887050539035,"url":"https://zeroheightsupport.zendesk.com/api/v2/help_center/en-us/articles/35887050539035.json","html_url":"https://help.zeroheight.com/hc/en-us/articles/35887050539035-zeroheight-API-Use-the-zeroheight-REST-API","author_id":4476925405467,"comments_disabled":false,"draft":false,"promoted":false,"position":19,"vote_sum":0,"vote_count":0,"upvote_count":0,"downvote_count":0,"section_id":36545439239451,"created_at":"2025-04-11T11:24:28Z","updated_at":"2026-11-06T10:13:26Z","name":"zeroheight API: Use the zeroheight REST API","title":"zeroheight API: Use the zeroheight REST API","source_locale":"en-us","locale":"en-us","outdated":false,"outdated_locales":[],"edited_at":"2026-11-06T10:13:26Z","user_segment_id":null,"permission_group_id":6414167334427,"content_tag_ids":[],"label_names":[],"body":"<zd-callout class=\"wysiwyg-callout wysiwyg-callout-info\" role=\"note\"><span class=\"wysiwyg-callout-icon\" aria-hidden=\"true\"></span><p>The API is included on Enterprise plans. It isn't available on Free or Starter. Want this and other premium features? <a href=\"https://zeroheight.com/pricing\" target=\"_blank\" rel=\"noopener noreferrer\">See our plans</a>.</p></zd-callout><p>The <a href=\"https://developers.zeroheight.com\">zeroheight API</a> lets you read your design system documentation from other tools, and now write to it as well. Use it to automate your design system workflow, build your own integrations, or keep zeroheight in step with the systems your team already uses.</p><figure class=\"wp-block-image size-full\"><p><img class=\"wp-image-74588\" src=\"https://help.zeroheight.com/hc/article_attachments/35887078436763\" alt=\"\"></p></figure><h2 id=\"h-what-can-i-do-with-the-zeroheight-api\">What can I do with the zeroheight API?</h2><p><strong>Read your documentation</strong></p><ul>\n<li data-list-item-id=\"e5867264f48c23bb1bb6bf72dbfd3296d\">Get the content of any page as structured data, Markdown or HTML, and search across a styleguide</li>\n<li data-list-item-id=\"e950da6409d5dd8b050b7c933449a17cd\">List styleguides, their navigation tree, categories, releases and page statuses</li>\n<li data-list-item-id=\"ecda43caa7c29a7f58c00aa52bd297664\">Pull the activity feed of page edits, status changes and releases</li>\n<li data-list-item-id=\"ee291b6c39c3288105615ae6d99ed9e84\">Export design tokens from your token sets in the format your pipeline needs</li>\n<li data-list-item-id=\"eb5263cd8dffff0a795dd73a4a7e75595\">List the component sets, design libraries, page templates, connected repositories and Storybooks a styleguide uses</li>\n</ul><p><strong>Write to your documentation</strong></p><ul>\n<li data-list-item-id=\"ecca590a3e4285e95642aaaef53788c68\">Create new pages and edit existing ones, from a quick find-and-replace to replacing a whole page</li>\n<li data-list-item-id=\"e965375fb349a2b0ed09fe64b001a5d24\">Rename, hide, move and reorder pages</li>\n<li data-list-item-id=\"e8fd012b1a2cfd261f43e7009aa04bc8f\">Create, rename and reorder navigations and categories</li>\n<li data-list-item-id=\"ef86643a28e3a79a570185b41039b1893\">Upload images and files to use in page content</li>\n<li data-list-item-id=\"efa80cc9f8ae20df78d78e93a4ad92a14\">Review the changes in a page draft and publish it</li>\n<li data-list-item-id=\"e3b567910d679b854ff75a8fcba7f4088\">Update page statuses, for example to keep them in sync with a project management tool</li>\n</ul><h2 id=\"h-writing-to-zeroheight\">Writing to zeroheight with the Editor API</h2><p>Until November 2026 the only way to create or edit page content from outside zeroheight was through the <a href=\"https://help.zeroheight.com/hc/en-us/articles/54955157637659\">zeroheight MCP</a>, which needs an AI tool in the loop. The Editor API opens the same capability to anything that can make an HTTP request: a build pipeline, a script, an internal tool or an agent you've built yourself.</p><p>Some things teams use it for:</p><ul>\n<li data-list-item-id=\"ee8c8cb0c41e9eab935b4c1670a048d37\">Generating component documentation from code or Storybook as part of a build, instead of copying it across by hand</li>\n<li data-list-item-id=\"ef756d9c67a0f4fb4c9b430dce3fc5218\">Migrating content from another tool, or keeping a page in sync with a source of truth that lives elsewhere</li>\n<li data-list-item-id=\"ef6f1ae74f74f55bfc82d36352868907d\">Filing documentation changes from an in-house agent or workflow tool</li>\n</ul><p><strong>Drafts and publishing</strong></p><p>On plans with draft pages, edits made through the API are saved to the page's draft by default, so an editor can review them in zeroheight before they go live. An integration can ask to publish directly instead. New pages are published straight away unless the integration asks for a draft. On plans without drafts, changes are published immediately.</p><p><strong>What you need</strong></p><ul>\n<li data-list-item-id=\"e9baa970ad711fa9d2d19038c426b150e\">A plan that includes the API (Professional or Enterprise)</li>\n<li data-list-item-id=\"e2451176691cc1622059a5968b68142e2\">Write access switched on for your organization under <strong>Your organization</strong> → <strong>Model Context Protocol (MCP)</strong>. It's on by default, and the same setting controls MCP write</li>\n<li data-list-item-id=\"eaeca3212a47f0d5cc9e34335b6a4b2cc\">An authentication token created with the <strong>Editor API</strong> use case. A token acts as the person who created it, so they need to be an editor or admin on the styleguide being written to</li>\n</ul><p>Page content is sent as editor XML, the same format the MCP uses. The API documentation describes every block, and the editor instructions endpoint returns the full format for an agent or script to follow.</p><h2 id=\"h-how-does-it-work\">How does it work?</h2><figure class=\"wp-block-embed is-type-video is-provider-youtube wp-block-embed-youtube wp-embed-aspect-16-9 wp-has-aspect-ratio\"><div data-oembed-url=\"https://youtu.be/D4qxykxUUa4?si=oHaPWRfsIDTQzst7\"><iframe src=\"//www.youtube-nocookie.com/embed/D4qxykxUUa4?si=oHaPWRfsIDTQzst7\" frameborder=\"0\" allowfullscreen=\"\" allow=\"encrypted-media\" style=\"width: 100%; aspect-ratio: 16 / 9;\"></iframe></div></figure><p>The API follows a <a href=\"http://en.wikipedia.org/wiki/Representational_State_Transfer\" target=\"_blank\" rel=\"noopener noreferrer\">REST</a> structure, so each resource (pages, styleguides, tokens, structure) has its own address and the HTTP method says what you want to do: <code>GET</code> to read a page, <code>POST</code> to create one, <code>PATCH</code> to edit it.</p><p>Every token can make 30 read requests and 30 write requests every 30 seconds. Going over returns a <code>429</code> response that says when to retry.</p><h2 id=\"h-authentication-tokens\">Authentication tokens</h2><p>Every request needs a token. Tokens belong to your team, carry only the scopes you give them, and can be revoked at any time. <a href=\"https://help.zeroheight.com/hc/en-us/articles/35887043412251-Zeroheight-API-Authentication-token-creation\">Read more about creating authentication tokens</a> and <a href=\"https://help.zeroheight.com/hc/en-us/articles/55715818607387-Authentication-tokens-choosing-a-use-case\">choosing a use case</a>.</p><h2 id=\"h-api-docs\">API docs</h2><p>Full API documentation is available at <a href=\"https://developers.zeroheight.com/\">developers.zeroheight.com</a>. The <a href=\"https://developers.zeroheight.com/75fe5b2ed/p/56b311-release-notes\">release notes</a> list what's been added in each version.</p>"}}