API changelog

We add to the API without breaking it: new endpoints, new optional parameters and new response fields can appear at any time, so ignore fields you do not know. Anything that would break an integration (a removed field, a changed type, a new required parameter) is announced here at least 90 days ahead and ships behind a new version.

2026-11-06

Added

• Official client libraries for PHP (chaosdesk/chaosdesk-php), Node.js (@chaosdesk/api) and Python (chaosdesk), generated from the OpenAPI document, and a Postman collection. See client libraries.
• Profiles and events API on the Zendesk-compatible API, shaped like Zendesk’s: PUT /zd/api/v2/user_profiles?identifier=, GET /zd/api/v2/users/{user_id}/profiles, POST /zd/api/v2/user_profiles/events, GET /zd/api/v2/users/{user_id}/events and more. Profiles from several systems resolve to one customer by email, phone or external id.
• App marketplace: developers submit apps built on the app framework for review; admins install reviewed apps with one click.
• Configuration as code: GET and POST /zd/api/v2/chaosdesk/config.yaml pull and push an account’s fields, forms, rules, SLAs and views as YAML, with a dry run.
• Zendesk-compatible API: users update, show_many and delete; organizations create, update, delete and search; satisfaction ratings; macros with apply; views with execute and counts; search export.

1.0.0

• First public version of the REST API (/api), documented in the API reference, and the Zendesk-compatible API (/zd/api/v2).