V4 change

src/pages/api/index.md

@@ -13,6 +13,7 @@ keywords:
   - Remap Links API
   - Document Info API
   - Convert PDF to InDesign API
+  - Convert InDesign to IDML API
   - REST API
   - cloud services
   - enterprise solutions

src/pages/config.md

@@ -33,6 +33,9 @@
     - Guides header
     - [Working with Custom Scripts API](/guides/working-with-custom-scripts-api/index.md)
     - [Working with Data Merge API](/guides/working-with-datamerge-api/index.md)
+    - [Working with Advanced Data Merge API](/guides/working-with-advanced-data-merge-api/index.md)
     - [Working with Rendition API](/guides/working-with-rendition-api/index.md)
+    - [Working with the Convert InDesign to IDML API](/guides/working-with-convert-indesign-to-idml-api/index.md)
     - [Writing Scripts for Custom Scripts API](/guides/writing-scripts-for-custom-scripts-api/index.md)
     - [Tips for PDF to InDesign Conversion](/guides/pdf-to-indesign-conversion-notes/index.md)
+    - [Using Adobe Fonts](/guides/using-adobe-fonts/index.md)

src/pages/contributors.json

@@ -1,35 +1,39 @@
 {
-  "total": 13,
+  "total": 16,
   "offset": 0,
-  "limit": 13,
+  "limit": 16,
   "data": [
     {
       "page": "/",
       "avatars": [
+        "https://avatars.githubusercontent.com/u/264675027?v=4",
         "https://avatars.githubusercontent.com/u/41382203?v=4",
         "https://avatars.githubusercontent.com/u/66052604?v=4",
         "https://avatars.githubusercontent.com/u/51445330?v=4",
         "https://avatars.githubusercontent.com/u/175690214?v=4",
         "https://avatars.githubusercontent.com/u/195011431?v=4"
       ],
-      "lastUpdated": "3/12/2026"
+      "lastUpdated": "11/2/2026"
     },
     {
       "page": "/api/",
       "avatars": [
+        "https://avatars.githubusercontent.com/u/264675027?v=4",
         "https://avatars.githubusercontent.com/u/51445330?v=4",
         "https://avatars.githubusercontent.com/u/195011431?v=4",
         "https://avatars.githubusercontent.com/u/41382203?v=4"
       ],
-      "lastUpdated": "2/27/2026"
+      "lastUpdated": "11/2/2026"
     },
     {
       "page": "/config",
       "avatars": [
+        "https://avatars.githubusercontent.com/u/264675027?v=4",
+        "https://avatars.githubusercontent.com/u/66052604?v=4",
         "https://avatars.githubusercontent.com/u/195011431?v=4",
         "https://avatars.githubusercontent.com/u/41382203?v=4"
       ],
-      "lastUpdated": "5/4/2026"
+      "lastUpdated": "11/2/2026"
     },
     {
       "page": "/getting-started/",
@@ -42,37 +46,40 @@
       "page": "/getting-started/changelog/",
       "avatars": [
         "https://avatars.githubusercontent.com/u/66052604?v=4",
-        "https://avatars.githubusercontent.com/u/274493592?v=4",
         "https://avatars.githubusercontent.com/u/264675027?v=4",
+        "https://avatars.githubusercontent.com/u/274493592?v=4",
         "https://avatars.githubusercontent.com/u/41382203?v=4"
       ],
-      "lastUpdated": "6/17/2026"
+      "lastUpdated": "11/2/2026"
     },
     {
       "page": "/getting-started/concepts/",
       "avatars": [
+        "https://avatars.githubusercontent.com/u/175690214?v=4",
         "https://avatars.githubusercontent.com/u/264675027?v=4",
         "https://avatars.githubusercontent.com/u/41382203?v=4"
       ],
-      "lastUpdated": "3/20/2026"
+      "lastUpdated": "8/27/2026"
     },
     {
       "page": "/getting-started/usage/",
       "avatars": [
+        "https://avatars.githubusercontent.com/u/175690214?v=4",
         "https://avatars.githubusercontent.com/u/66052604?v=4",
         "https://avatars.githubusercontent.com/u/41382203?v=4"
       ],
-      "lastUpdated": "6/17/2026"
+      "lastUpdated": "10/27/2026"
     },
     {
       "page": "/guides/",
       "avatars": [
+        "https://avatars.githubusercontent.com/u/264675027?v=4",
+        "https://avatars.githubusercontent.com/u/66052604?v=4",
         "https://avatars.githubusercontent.com/u/195011431?v=4",
         "https://avatars.githubusercontent.com/u/41382203?v=4",
-        "https://avatars.githubusercontent.com/u/66052604?v=4",
         "https://avatars.githubusercontent.com/u/51445330?v=4"
       ],
-      "lastUpdated": "3/26/2026"
+      "lastUpdated": "11/2/2026"
     },
     {
       "page": "/guides/pdf-to-indesign-conversion-notes/",
@@ -82,6 +89,28 @@
       ],
       "lastUpdated": "3/26/2026"
     },
+    {
+      "page": "/guides/using-adobe-fonts/",
+      "avatars": [
+        "https://avatars.githubusercontent.com/u/66052604?v=4"
+      ],
+      "lastUpdated": "11/1/2026"
+    },
+    {
+      "page": "/guides/working-with-advanced-data-merge-api/",
+      "avatars": [
+        "https://avatars.githubusercontent.com/u/66052604?v=4",
+        "https://avatars.githubusercontent.com/u/274493592?v=4"
+      ],
+      "lastUpdated": "11/1/2026"
+    },
+    {
+      "page": "/guides/working-with-convert-indesign-to-idml-api/",
+      "avatars": [
+        "https://avatars.githubusercontent.com/u/264675027?v=4"
+      ],
+      "lastUpdated": "11/2/2026"
+    },
     {
       "page": "/guides/working-with-custom-scripts-api/",
       "avatars": [
@@ -96,20 +125,22 @@
     {
       "page": "/guides/working-with-datamerge-api/",
       "avatars": [
+        "https://avatars.githubusercontent.com/u/175690214?v=4",
+        "https://avatars.githubusercontent.com/u/66052604?v=4",
         "https://avatars.githubusercontent.com/u/274493592?v=4",
         "https://avatars.githubusercontent.com/u/41382203?v=4",
-        "https://avatars.githubusercontent.com/u/66052604?v=4",
         "https://avatars.githubusercontent.com/u/195011431?v=4"
       ],
-      "lastUpdated": "5/5/2026"
+      "lastUpdated": "8/27/2026"
     },
     {
       "page": "/guides/working-with-rendition-api/",
       "avatars": [
+        "https://avatars.githubusercontent.com/u/175690214?v=4",
         "https://avatars.githubusercontent.com/u/41382203?v=4",
         "https://avatars.githubusercontent.com/u/195011431?v=4"
       ],
-      "lastUpdated": "2/25/2026"
+      "lastUpdated": "8/27/2026"
     },
     {
       "page": "/guides/writing-scripts-for-custom-scripts-api/",

src/pages/getting-started/changelog/index.md

@@ -13,6 +13,7 @@ keywords:
   - Custom Scripts API
   - Remap Links API
   - Convert PDF to InDesign API
+  - Convert InDesign to IDML API
   - PDF to InDesign
   - REST API
   - cloud services
@@ -41,6 +42,27 @@ twitter:
 
 This page contains the release notes and version history for Adobe InDesign APIs. Stay updated with the latest features, improvements, and bug fixes.
 
+## November 2, 2026
+
+### New Features
+
+*Convert InDesign to IDML API*
+
+- **Convert an InDesign document to IDML:** New `POST /v3/convert-indesign-to-idml` endpoint converts an INDD file to IDML. [View endpoint documentation][22]. See [Working with the Convert InDesign to IDML API][23] for a quickstart.
+
+*Advanced Data Merge*
+
+- **Output Path Structure**: The `POST /v4/merge-data` endpoint no longer nests outputs into `rangeN` batch subfolders. Every output file is written directly into the resolved output folder, and naming collisions between batches or records are resolved with a `(n)` suffix on the filename instead. [Learn more about output path variations.][20]
+- **Parameter Name Change**: The `pagesPerDocument` parameter from the base Data Merge API has been renamed to `recordsPerFile` in the `POST /v4/merge-data` endpoint. The underlying behavior is unchanged. [Learn more about the parameter name change.][21]
+- **Conditional Visibility & Dynamic Styling**: The `POST /v4/merge-data` endpoint now accepts a `rulesFile` parameter, letting a rules JSON file show/hide layers, frames, and placeholders, restyle and recolor content, replace text, and resize or move frames — differently per record. [Learn more about conditional visibility & dynamic styling.][16]
+- **Copyfitting**: New `copyfittingSettings` object in `params` automatically reduces font size within defined limits to resolve overset text after a merge. [Learn more about copyfitting.][17]
+- **Folder Structure & Zipped Output**: The `POST /v4/merge-data` endpoint supports organizing merge outputs into a folder hierarchy via a `~`-prefixed CSV column, plus optional zipped output using `outputCompressMediaType`. [Learn more about folder structure and zipped output.][18]
+- **Pre-signed URL Support in CSV**: A new `preSignedURL` parameter allows image placeholder columns (prefixed with `@`) to contain pre-signed URLs directly in the CSV, fetched during the merge. [Learn more about pre-signed URL support.][19]
+
+*Adobe Fonts Enablement*
+
+- **Adobe Fonts Free library support**: InDesign API can now resolve fonts from the [Adobe Fonts Free library](https://fonts.adobe.com/fonts?library=basic) automatically through your Adobe entitlement, so you no longer need to upload or host those font files. To enable this feature, add a Fonts-enabled product profile to your API credential. [Learn more about using Adobe Fonts.][24]
+
 ## June 2, 2026
 
 ### Enhancements
@@ -145,3 +167,12 @@ This page contains the release notes and version history for Adobe InDesign APIs
 [13]: ../concepts/index.md#api-capability-naming-rules
 [14]: ../../guides/working-with-datamerge-api/index.md#variable-file-naming-support-in-data-merge-api
 [15]: ../usage/index.md#file-size-limits
+[16]: ../../guides/working-with-advanced-data-merge-api/index.md#conditional-visibility--dynamic-styling
+[17]: ../../guides/working-with-advanced-data-merge-api/index.md#copyfitting
+[18]: ../../guides/working-with-advanced-data-merge-api/index.md#folder-structure-and-zipped-output
+[19]: ../../guides/working-with-advanced-data-merge-api/index.md#pre-signed-url-support-in-csv
+[20]: ../../guides/working-with-advanced-data-merge-api/index.md#output-path-variations-in-advanced-data-merge-api
+[21]: ../../guides/working-with-advanced-data-merge-api/index.md#parameter-name-change-in-advanced-data-merge-api
+[22]: ../../api/index.md#tag/Convert-InDesign-to-IDML
+[23]: ../../guides/working-with-convert-indesign-to-idml-api/index.md
+[24]: ../../guides/using-adobe-fonts/index.md

src/pages/getting-started/concepts/index.md

@@ -92,6 +92,25 @@ platform can upload. You can provide this information in the `outputs` array wit
 
 Each storage provider may have its own requirements for creating PUT or POST pre-signed URLs. Please follow the documentation from the individual storage provider creating these URLs.
 
+## Output file naming convention
+
+When a request produces more than one output file from a single base name (for example, one file per page in the [Rendition API][10], or one file per record in the [Data Merge API][11]), the file names follow InDesign's own native sequential-export naming convention — not an underscore- or hyphen-delimited scheme:
+
+- The first file uses the base name as-is: `{outputFileBaseString}.{ext}`
+- Each subsequent file appends its index directly after the base name, with no separator: `{outputFileBaseString}{index}.{ext}`
+- `{ext}` is derived from the requested `outputMediaType` (for example, `image/png` → `.png`, `image/jpeg` → `.jpg`).
+
+For example, with `outputFileBaseString` set to `banner`:
+
+- `banner.png`
+- `banner2.png`
+- `banner3.png`
+- ...
+
+**Caution:** Because there is no separator, a base string that ends in a digit makes the generated file names ambiguous to parse back into base + index without already knowing the base string. For example, base string `hero9` at index 10 produces `hero910.png`, which is indistinguishable from base string `hero91` at index 0. Avoid base strings that end in a digit if your integration needs to derive the page or record index from the file name, or track expected file names by position/index rather than by parsing the generated name.
+
+If you register per-file destinations using the `outputs` array (see [Output assets](#output-assets)), predict each file's name using this convention when setting its `source` field — a mismatched `source` means that file silently fails to upload to your registered destination.
+
 ## About custom script bundles
 
 To create a script to use with the Custom Scripts API, you'll need to prepare a script bundle, a ZIP file with a predefined structure.
@@ -436,3 +455,5 @@ Once validation is complete, update your production scripts to use the new app v
 [7]: https://learn.microsoft.com/en-us/azure/ai-services/translator/document-translation/how-to-guides/create-sas-tokens?tabs=Containers
 [8]: ../../guides/writing-scripts-for-custom-scripts-api/index.md
 [9]: https://developer.adobe.com/events/docs/guides/using/indesign-apis/indesign-apis-events-data-stream-setup/
+[10]: ../../guides/working-with-rendition-api/index.md
+[11]: ../../guides/working-with-datamerge-api/index.md

src/pages/getting-started/usage/index.md

@@ -34,15 +34,19 @@ For the latest updates, new features, and bug fixes, [check InDesign's changelog
 
 To maintain API stability and fair usage across clients, the following limits are enforced:
 
-* Soft limit: 250 requests per minute across all endpoints. Once this limit is crossed, you may experience slower responses.
+* General API requests: A hard limit of 250 requests per minute (RPM) applies across all endpoints except the Status API. You can send all 250 requests at once. Once the limit is reached, additional requests within the same one-minute window are throttled.
 
-* Hard limit: 350 requests per minute. Requests beyond this limit are rejected.
+* Status API requests: These do not count toward the 250 RPM limit and have a separate rate limit of 1,000 RPM.
 
 ### File size limits
 
 * Assets: Maximum supported size is 2GB per asset.
 * Custom Scripts API: Maximum allowed size for a Custom Script ZIP upload is 5MB.
 
+### Payload size limit
+
+The total request payload size must not exceed 1 MB.
+
 ### Assets
 
 The number of assets (input + output) that can be passed in a single payload is 1000.

src/pages/guides/index.md

@@ -8,6 +8,7 @@ keywords:
   - document processing
   - Data Merge API
   - Rendition API
+  - Convert InDesign to IDML API
   - Custom Scripts API
   - Remap Links API
   - REST API
@@ -32,8 +33,12 @@ This guide covers advanced scripting techniques for automating InDesign tasks.
 - [Working with Custom Scripts API](./working-with-custom-scripts-api/index.md) - Advanced scripting techniques
 - [Writing Scripts for Custom Scripts API](./writing-scripts-for-custom-scripts-api/index.md) - Script development and logging
 - [Working with Data Merge API](./working-with-datamerge-api/index.md) - Data merge automation
+- [Working with Advanced Data Merge API](./working-with-advanced-data-merge-api/index.md) - Advanced data merge techniques, Conditional Visibility, Styling, Copyfitting and more
 - [Working with Rendition API](./working-with-rendition-api/index.md) - Document rendering
+- [Working with the Convert InDesign to IDML API](./working-with-convert-indesign-to-idml-api/index.md) - Convert an InDesign document to IDML
 - [Tips for PDF to InDesign Conversion](./pdf-to-indesign-conversion-notes/index.md) - PDF To InDesign Points to note and limitations
+- [Using Adobe Fonts(Free) with InDesign API](./using-adobe-fonts/index.md) - Enable Free Adobe Fonts
+
 
 <HorizontalLine />