From 4fd7007bc54d186597faf0e3e6f9515330e64887 Mon Sep 17 00:00:00 2001 From: petheanraj-mitrah Date: Mon, 31 Aug 2026 20:45:32 +0530 Subject: [PATCH 1/8] docs: update REST APIs sidebar navigation and OpenAPI tag cross-links --- src/pages/config.md | 4 ++-- src/pages/overview/apis/index.md | 7 +++++++ static/openapi.json | 4 ++-- 3 files changed, 11 insertions(+), 4 deletions(-) create mode 100644 src/pages/overview/apis/index.md diff --git a/src/pages/config.md b/src/pages/config.md index 39d066d11..2ad0e65b8 100644 --- a/src/pages/config.md +++ b/src/pages/config.md @@ -17,12 +17,11 @@ - Resources - [Developer Resources](https://developer.adobe.com/document-services/resources/) - [Forum](https://community.adobe.com/t5/document-services-apis/bd-p/Document-Cloud-SDK?page=1&sort=latest_replies&filter=all) - - [Licensing](overview/limits.md) + - [Licensing and Usage Limits](overview/limits.md) - [Sales FAQ](https://developer.adobe.com/document-services/faq/sales/) - [Tech Support FAQ](https://developer.adobe.com/document-services/faq/tech-support/) - [Contact Us](https://developer.adobe.com/document-services/pricing/contact/) - [Documentation](overview/index.md) - - [REST APIs](apis/index.md) - [Get credentials](https://acrobatservices.adobe.com/dc-integration-creation-app-cdn/main.html) - subPages: - [Introduction](overview/index.md) @@ -135,6 +134,7 @@ - [Support](overview/support.md) - [Technical FAQ](overview/faq.md) - [API Status](overview/status.md) + - [REST APIs](overview/apis/index.md) - [Legacy Documentation](overview/legacy-documentation/index.md) - [Introduction](overview/legacy-documentation/index.md) - [PDF Services API](overview/legacy-documentation/pdf-services-api/index.md) diff --git a/src/pages/overview/apis/index.md b/src/pages/overview/apis/index.md new file mode 100644 index 000000000..0e1110386 --- /dev/null +++ b/src/pages/overview/apis/index.md @@ -0,0 +1,7 @@ +--- +title: Adobe PDF Services Open API spec +description: The OpenAPI spec for Adobe PDF Services API endpoints, parameters, and responses. +layout: none +--- + + diff --git a/static/openapi.json b/static/openapi.json index 3a6ba4c8e..fd1b1d26b 100644 --- a/static/openapi.json +++ b/static/openapi.json @@ -36,11 +36,11 @@ }, { "name": "Extract PDF", - "description": "Extract content from PDF documents and output it in a structured JSON format, along with tables and figures" + "description": "Extract content from PDF documents and output it in a structured JSON format, along with tables and figures.\n\nFor the PDF to Markdown API, see [this page](https://developer.adobe.com/document-services/docs/apis/#tag/PDF-To-Markdown)." }, { "name": "PDF To Markdown", - "description": "Extract content from PDF documents and output it in a well-formatted LLM-friendly Markdown text, along with tables and figures" + "description": "Extract content from PDF documents and output it in a well-formatted LLM-friendly Markdown text, along with tables and figures.\n\nFor the PDF to JSON API, see [this page](https://developer.adobe.com/document-services/docs/apis/#tag/Extract-PDF)." }, { "name": "Html to PDF", From 33eeff75ad39dac7145496e461abc95c85fc2e9d Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Wed, 2 Sep 2026 10:49:04 +0000 Subject: [PATCH 2/8] chore: auto-generate contributors --- src/pages/contributors.json | 14 +++++++++++--- 1 file changed, 11 insertions(+), 3 deletions(-) diff --git a/src/pages/contributors.json b/src/pages/contributors.json index 6b368f6f7..9a380b7f6 100644 --- a/src/pages/contributors.json +++ b/src/pages/contributors.json @@ -1,7 +1,7 @@ { - "total": 202, + "total": 203, "offset": 0, - "limit": 202, + "limit": 203, "data": [ { "page": "/apis/", @@ -17,11 +17,12 @@ { "page": "/config", "avatars": [ + "https://avatars.githubusercontent.com/u/315701719?v=4", "https://avatars.githubusercontent.com/u/298222561?v=4", "https://avatars.githubusercontent.com/u/276200381?v=4", "https://avatars.githubusercontent.com/u/14320591?v=4" ], - "lastUpdated": "7/22/2026" + "lastUpdated": "8/31/2026" }, { "page": "/overview/", @@ -36,6 +37,13 @@ ], "lastUpdated": "5/1/2026" }, + { + "page": "/overview/apis/", + "avatars": [ + "https://avatars.githubusercontent.com/u/315701719?v=4" + ], + "lastUpdated": "8/31/2026" + }, { "page": "/overview/document-generation-api/", "avatars": [ From 1c9f2f495c6e591625c93ef138ee21731b525c41 Mon Sep 17 00:00:00 2001 From: petheanraj-mitrah Date: Tue, 8 Sep 2026 17:12:04 +0530 Subject: [PATCH 3/8] feat: add site configuration file with navigation and page structure definitions --- src/pages/config.md | 31 +++++++++++++++---------------- 1 file changed, 15 insertions(+), 16 deletions(-) diff --git a/src/pages/config.md b/src/pages/config.md index 2ad0e65b8..2cdd7ffa7 100644 --- a/src/pages/config.md +++ b/src/pages/config.md @@ -2,25 +2,24 @@ - /document-services/docs/ - pages: - - [Adobe Acrobat Services](https://developer.adobe.com/document-services/) + - [Adobe Acrobat Services](/document-services/) - APIs - - [PDF Services](https://developer.adobe.com/document-services/apis/pdf-services/) Create, combine and export PDFs - - [PDF Accessibility Auto-Tag](https://developer.adobe.com/document-services/apis/pdf-accessibility-auto-tag/) Auto-tag PDF content to improve accessibility - - [PDF Extract](https://developer.adobe.com/document-services/apis/pdf-extract/) Extract text, tables, images, and document structure - - [Document Generation](https://developer.adobe.com/document-services/apis/doc-generation/) Generate PDF and Word documents from custom Word templates - - [Electronic Seal API](https://developer.adobe.com/document-services/apis/electronic-seal-api/) Electronically seal PDF documents at scale to provide document athenticity and identity - - [PDF Embed](https://developer.adobe.com/document-services/apis/pdf-embed/) Embed high-fidelity PDFs in web apps with analytics - - [Sign API](https://developer.adobe.com/document-services/apis/sign-api/) Integrate e-signatures into your platform or application - - [Power Automate Connector](https://developer.adobe.com/document-services/apis/microsoft-pa-integration/) Build workflows on Microsoft Power Platform easily - - [Use Cases](https://developer.adobe.com/document-services/use-cases/agreements-and-contracts/sales-proposals-and-contracts/) - - [Pricing](https://developer.adobe.com/document-services/pricing/main/) + - [PDF Services](/document-services/apis/pdf-services/) Create, combine and export PDFs + - [PDF Accessibility APIs](/document-services/apis/pdf-accessibility-apis/) Auto-Tag API and Checker API to improve accessibility + - [PDF Extract](/document-services/apis/pdf-extract/) Extract text, tables, images, and document structure to JSON or Markdown + - [Document Generation](/document-services/apis/doc-generation/) Generate PDF and Word documents from custom Word templates + - [PDF Embed](/document-services/apis/pdf-embed/) Embed high-fidelity PDFs in web apps with analytics + - [Power Automate Connector](/document-services/apis/microsoft-pa-integration/) Build workflows on Microsoft Power Platform easily + - [Sign API](/document-services/apis/sign-api/) Integrate e-signatures into your platform or application + - [Electronic Seal API](/document-services/apis/electronic-seal-api/) Electronically seal PDF documents at scale to provide document athenticity and identity + - [Pricing](/document-services/pricing/main/) - Resources - - [Developer Resources](https://developer.adobe.com/document-services/resources/) + - [Customer Stories](/document-services/resources/customer-stories/) - [Forum](https://community.adobe.com/t5/document-services-apis/bd-p/Document-Cloud-SDK?page=1&sort=latest_replies&filter=all) - [Licensing and Usage Limits](overview/limits.md) - - [Sales FAQ](https://developer.adobe.com/document-services/faq/sales/) - - [Tech Support FAQ](https://developer.adobe.com/document-services/faq/tech-support/) - - [Contact Us](https://developer.adobe.com/document-services/pricing/contact/) + - [Sales FAQ](/document-services/faq/sales/) + - [Tech Support FAQ](/document-services/faq/tech-support/) + - [Contact Us](/document-services/pricing/contact/) - [Documentation](overview/index.md) - [Get credentials](https://acrobatservices.adobe.com/dc-integration-creation-app-cdn/main.html) - subPages: @@ -42,7 +41,7 @@ - [Compress PDFs](overview/pdf-services-api/howtos/compress-pdf.md) - [Create PDF](overview/pdf-services-api/howtos/create-pdf.md) - [Delete Pages](overview/pdf-services-api/howtos/delete-pages.md) - - [Document Generation](https://developer.adobe.com/document-services/docs/overview/document-generation-api/) + - [Document Generation](/document-services/docs/overview/document-generation-api/) - [Export PDF](overview/pdf-services-api/howtos/export-pdf.md) - [Export PDF Form Data](overview/pdf-services-api/howtos/export-pdf-form-data.md) - [Extract PDF](overview/pdf-services-api/howtos/extract-pdf.md) From 9c404458b36fd2ee52f395ef6b8776c5b2c8c931 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" Date: Tue, 8 Sep 2026 12:04:00 +0000 Subject: [PATCH 4/8] chore: auto-generate contributors --- src/pages/contributors.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/contributors.json b/src/pages/contributors.json index 9a380b7f6..aef93246c 100644 --- a/src/pages/contributors.json +++ b/src/pages/contributors.json @@ -22,7 +22,7 @@ "https://avatars.githubusercontent.com/u/276200381?v=4", "https://avatars.githubusercontent.com/u/14320591?v=4" ], - "lastUpdated": "8/31/2026" + "lastUpdated": "9/8/2026" }, { "page": "/overview/", From 4e4e3adc5e3121fc28c6c8b2cbbcd6fe2a0a1058 Mon Sep 17 00:00:00 2001 From: petheanraj-mitrah Date: Tue, 8 Sep 2026 19:14:37 +0530 Subject: [PATCH 5/8] feat: add site configuration navigation and documentation hierarchy in config.md --- src/pages/config.md | 30 +++++++++++++++--------------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/src/pages/config.md b/src/pages/config.md index 2cdd7ffa7..509ee86c4 100644 --- a/src/pages/config.md +++ b/src/pages/config.md @@ -2,24 +2,24 @@ - /document-services/docs/ - pages: - - [Adobe Acrobat Services](/document-services/) + - [Adobe Acrobat Services](/) - APIs - - [PDF Services](/document-services/apis/pdf-services/) Create, combine and export PDFs - - [PDF Accessibility APIs](/document-services/apis/pdf-accessibility-apis/) Auto-Tag API and Checker API to improve accessibility - - [PDF Extract](/document-services/apis/pdf-extract/) Extract text, tables, images, and document structure to JSON or Markdown - - [Document Generation](/document-services/apis/doc-generation/) Generate PDF and Word documents from custom Word templates - - [PDF Embed](/document-services/apis/pdf-embed/) Embed high-fidelity PDFs in web apps with analytics - - [Power Automate Connector](/document-services/apis/microsoft-pa-integration/) Build workflows on Microsoft Power Platform easily - - [Sign API](/document-services/apis/sign-api/) Integrate e-signatures into your platform or application - - [Electronic Seal API](/document-services/apis/electronic-seal-api/) Electronically seal PDF documents at scale to provide document athenticity and identity - - [Pricing](/document-services/pricing/main/) + - [PDF Services](/apis/pdf-services/) Create, combine and export PDFs + - [PDF Accessibility APIs](/apis/pdf-accessibility-apis/) Auto-Tag API and Checker API to improve accessibility + - [PDF Extract](/apis/pdf-extract/) Extract text, tables, images, and document structure to JSON or Markdown + - [Document Generation](/apis/doc-generation/) Generate PDF and Word documents from custom Word templates + - [PDF Embed](/apis/pdf-embed/) Embed high-fidelity PDFs in web apps with analytics + - [Power Automate Connector](/apis/microsoft-pa-integration/) Build workflows on Microsoft Power Platform easily + - [Sign API](/apis/sign-api/) Integrate e-signatures into your platform or application + - [Electronic Seal API](/apis/electronic-seal-api/) Electronically seal PDF documents at scale to provide document athenticity and identity + - [Pricing](/pricing/main/) - Resources - - [Customer Stories](/document-services/resources/customer-stories/) + - [Customer Stories](/resources/customer-stories/) - [Forum](https://community.adobe.com/t5/document-services-apis/bd-p/Document-Cloud-SDK?page=1&sort=latest_replies&filter=all) - [Licensing and Usage Limits](overview/limits.md) - - [Sales FAQ](/document-services/faq/sales/) - - [Tech Support FAQ](/document-services/faq/tech-support/) - - [Contact Us](/document-services/pricing/contact/) + - [Sales FAQ](/faq/sales/) + - [Tech Support FAQ](/faq/tech-support/) + - [Contact Us](/pricing/contact/) - [Documentation](overview/index.md) - [Get credentials](https://acrobatservices.adobe.com/dc-integration-creation-app-cdn/main.html) - subPages: @@ -41,7 +41,7 @@ - [Compress PDFs](overview/pdf-services-api/howtos/compress-pdf.md) - [Create PDF](overview/pdf-services-api/howtos/create-pdf.md) - [Delete Pages](overview/pdf-services-api/howtos/delete-pages.md) - - [Document Generation](/document-services/docs/overview/document-generation-api/) + - [Document Generation](/docs/overview/document-generation-api/) - [Export PDF](overview/pdf-services-api/howtos/export-pdf.md) - [Export PDF Form Data](overview/pdf-services-api/howtos/export-pdf-form-data.md) - [Extract PDF](overview/pdf-services-api/howtos/extract-pdf.md) From 6454979c9f629b378c7d1f253fbd2f6e6807a961 Mon Sep 17 00:00:00 2001 From: petheanraj-mitrah Date: Tue, 8 Sep 2026 19:23:25 +0530 Subject: [PATCH 6/8] Fix link formatting for PDF Services section --- src/pages/config.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/config.md b/src/pages/config.md index 509ee86c4..f30e12942 100644 --- a/src/pages/config.md +++ b/src/pages/config.md @@ -4,7 +4,7 @@ - pages: - [Adobe Acrobat Services](/) - APIs - - [PDF Services](/apis/pdf-services/) Create, combine and export PDFs + - [PDF Services](apis/pdf-services/) Create, combine and export PDFs - [PDF Accessibility APIs](/apis/pdf-accessibility-apis/) Auto-Tag API and Checker API to improve accessibility - [PDF Extract](/apis/pdf-extract/) Extract text, tables, images, and document structure to JSON or Markdown - [Document Generation](/apis/doc-generation/) Generate PDF and Word documents from custom Word templates From 2ec285ae8b117950efd3550b43f4853aaa9ce186 Mon Sep 17 00:00:00 2001 From: petheanraj-mitrah Date: Tue, 8 Sep 2026 19:30:48 +0530 Subject: [PATCH 7/8] Update PDF Services link in config.md --- src/pages/config.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/pages/config.md b/src/pages/config.md index f30e12942..b64c69949 100644 --- a/src/pages/config.md +++ b/src/pages/config.md @@ -4,7 +4,7 @@ - pages: - [Adobe Acrobat Services](/) - APIs - - [PDF Services](apis/pdf-services/) Create, combine and export PDFs + - [PDF Services](/document-services/docs/../apis/pdf-services/) Create, combine and export PDFs - [PDF Accessibility APIs](/apis/pdf-accessibility-apis/) Auto-Tag API and Checker API to improve accessibility - [PDF Extract](/apis/pdf-extract/) Extract text, tables, images, and document structure to JSON or Markdown - [Document Generation](/apis/doc-generation/) Generate PDF and Word documents from custom Word templates From 9db1165044ec5d49cfb5a63ee4109470a995f870 Mon Sep 17 00:00:00 2001 From: petheanraj-mitrah Date: Tue, 8 Sep 2026 19:55:09 +0530 Subject: [PATCH 8/8] feat: add navigation configuration for Document Services documentation site --- src/pages/config.md | 31 ++++++++++++++++--------------- 1 file changed, 16 insertions(+), 15 deletions(-) diff --git a/src/pages/config.md b/src/pages/config.md index b64c69949..821722084 100644 --- a/src/pages/config.md +++ b/src/pages/config.md @@ -2,24 +2,25 @@ - /document-services/docs/ - pages: - - [Adobe Acrobat Services](/) + - [Adobe Acrobat Services](https://developer.adobe.com/document-services/) - APIs - - [PDF Services](/document-services/docs/../apis/pdf-services/) Create, combine and export PDFs - - [PDF Accessibility APIs](/apis/pdf-accessibility-apis/) Auto-Tag API and Checker API to improve accessibility - - [PDF Extract](/apis/pdf-extract/) Extract text, tables, images, and document structure to JSON or Markdown - - [Document Generation](/apis/doc-generation/) Generate PDF and Word documents from custom Word templates - - [PDF Embed](/apis/pdf-embed/) Embed high-fidelity PDFs in web apps with analytics - - [Power Automate Connector](/apis/microsoft-pa-integration/) Build workflows on Microsoft Power Platform easily - - [Sign API](/apis/sign-api/) Integrate e-signatures into your platform or application - - [Electronic Seal API](/apis/electronic-seal-api/) Electronically seal PDF documents at scale to provide document athenticity and identity - - [Pricing](/pricing/main/) + - [PDF Services](https://developer.adobe.com/document-services/apis/pdf-services/) Create, combine and export PDFs + - [PDF Accessibility Auto-Tag](https://developer.adobe.com/document-services/apis/pdf-accessibility-auto-tag/) Auto-tag PDF content to improve accessibility + - [PDF Extract](https://developer.adobe.com/document-services/apis/pdf-extract/) Extract text, tables, images, and document structure + - [Document Generation](https://developer.adobe.com/document-services/apis/doc-generation/) Generate PDF and Word documents from custom Word templates + - [Electronic Seal API](https://developer.adobe.com/document-services/apis/electronic-seal-api/) Electronically seal PDF documents at scale to provide document athenticity and identity + - [PDF Embed](https://developer.adobe.com/document-services/apis/pdf-embed/) Embed high-fidelity PDFs in web apps with analytics + - [Sign API](https://developer.adobe.com/document-services/apis/sign-api/) Integrate e-signatures into your platform or application + - [Power Automate Connector](https://developer.adobe.com/document-services/apis/microsoft-pa-integration/) Build workflows on Microsoft Power Platform easily + - [Use Cases](https://developer.adobe.com/document-services/use-cases/agreements-and-contracts/sales-proposals-and-contracts/) + - [Pricing](https://developer.adobe.com/document-services/pricing/main/) - Resources - - [Customer Stories](/resources/customer-stories/) + - [Developer Resources](https://developer.adobe.com/document-services/resources/) - [Forum](https://community.adobe.com/t5/document-services-apis/bd-p/Document-Cloud-SDK?page=1&sort=latest_replies&filter=all) - [Licensing and Usage Limits](overview/limits.md) - - [Sales FAQ](/faq/sales/) - - [Tech Support FAQ](/faq/tech-support/) - - [Contact Us](/pricing/contact/) + - [Sales FAQ](https://developer.adobe.com/document-services/faq/sales/) + - [Tech Support FAQ](https://developer.adobe.com/document-services/faq/tech-support/) + - [Contact Us](https://developer.adobe.com/document-services/pricing/contact/) - [Documentation](overview/index.md) - [Get credentials](https://acrobatservices.adobe.com/dc-integration-creation-app-cdn/main.html) - subPages: @@ -41,7 +42,7 @@ - [Compress PDFs](overview/pdf-services-api/howtos/compress-pdf.md) - [Create PDF](overview/pdf-services-api/howtos/create-pdf.md) - [Delete Pages](overview/pdf-services-api/howtos/delete-pages.md) - - [Document Generation](/docs/overview/document-generation-api/) + - [Document Generation](https://developer.adobe.com/document-services/docs/overview/document-generation-api/) - [Export PDF](overview/pdf-services-api/howtos/export-pdf.md) - [Export PDF Form Data](overview/pdf-services-api/howtos/export-pdf-form-data.md) - [Extract PDF](overview/pdf-services-api/howtos/extract-pdf.md)