Change announcement: Documents API v1 deprecated, migrate to v2 by July 2027

Building integrations around architecture decisions now requires fewer API calls. The documents API v2 replaces a fragmented multi-call design with clean, atomic requests, making it simpler to programmatically create, retrieve, and update architecture decisions and their templates. V2 also introduces markdown export, so you can sync decisions directly into documentation sites or other tools.

The documents API is used to manage architecture decisions and decision templates through code, automating decision creation, syncing them with external systems, and building custom tooling on top of your architecture governance workflows. If you are not yet using the documents API, we recommend starting on v2 directly to avoid a migration later.

Transition timeline

• July 2026: v1 is officially deprecated. All v1 responses now include deprecation headers.

• July 2026 to July 2027: Both APIs remain fully functional. Migrate your integrations at your own pace.

• 31 July 2027: v1 will be removed. Only v2 will be available after this date.

What you need to do

If your integration uses the documents API v1, update it to v2 before 31 July 2027. See the migration guide for step-by-step instructions, code examples, and a full list of breaking changes. For questions, contact the SAP LeanIX support team.