{
"openapi": "3.0.0",
"info": {
"description": "Firefly Service's RESTful InDesign APIs offer resources to automate tedious, time-consuming design tasks through scalable cloud services, encouraging more personalization at scale, creative automation, and faster content delivery. ",
"version": "",
"title": "Firefly Services - InDesign APIs",
"termsOfService": "https://www.adobe.com/content/dam/cc/en/legal/terms/enterprise/pdfs/PSLT-AdobeCreativeAPI-WW-2024v2.pdf",
"contact": {
"email": "idservices@adobe.com"
}
},
"servers": [
{
"url": "https://indesign.adobe.io"
}
],
"security": [
{
"ApiKeyAuth": []
},
{
"BearerAuth": []
}
],
"tags": [
{
"name": "Data Merge API",
"description": "The Data Merge API is used to create document variations from CSV data and an InDesign file.
The Data Merge API supports UTF-16BE encoding for CSV files, which is necessary for languages or characters requiring multi-byte representation. For plain English characters, the CSV will function correctly even without this encoding."
},
{
"name": "Remap Links API",
"description": "The Remap Links API allows you to replace file-based links in InDesign documents with AEM URLs. This is particularly useful for customers working with Adobe Experience Manager (AEM) using Adobe Asset Link, enabling designers to work with output files that have direct links to AEM URLs."
},
{
"name": "Rendition API",
"description": "The Rendition API creates a version of a file in a specified format (e.g., PNG, JPEG, or PDF)."
},
{
"name": "Custom Scripts API",
"description": "The Custom Scripts API allows you to submit custom scripts to do almost anything you can do in InDesign through scripting."
}
],
"paths": {
"/v3/merge-data": {
"post": {
"summary": "Perform a data merge",
"description": "Returns InDesign documents or PDFs that are created by merging the data provided and the specified template.
The data merge output MIME types are: `application/pdf` for PDF.
`application/x-indesign` for INDD.
",
"operationId": "dataMerge",
"tags": [
"Data Merge API"
],
"parameters": [
{
"name": "x-gw-ims-org-id",
"in": "header",
"description": "This is the identifier for Adobe Identity Management Service (IMS) as defined in Adobe's developer console. This is optional.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "x-api-key",
"in": "header",
"description": "The API key as defined in Adobe's developer console.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "Authorization",
"in": "header",
"description": "The authorization token with bearer \"token_value\".",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MergeDataRequest"
}
}
},
"description": "This job request object specifies parameters for merging the data with the given template.",
"required": true
},
"responses": {
"202": {
"$ref": "#/components/responses/Accepted"
},
"400": {
"$ref": "#/components/responses/BadParams"
},
"401": {
"$ref": "#/components/responses/Unauthorized"
},
"403": {
"$ref": "#/components/responses/Forbidden"
},
"404": {
"$ref": "#/components/responses/NotFound"
},
"429": {
"$ref": "#/components/responses/TooManyRequests"
},
"500": {
"$ref": "#/components/responses/InternalServerError"
}
}
}
},
"/v3/merge-data-tags": {
"post": {
"summary": "Get data merge tags",
"description": "Retrieves the data merge tags from a document.",
"operationId": "dataMergeTags",
"tags": [
"Data Merge API"
],
"parameters": [
{
"name": "x-gw-ims-org-id",
"in": "header",
"description": "This is the identifier for Adobe Identity Management Service (IMS) as defined in Adobe's developer console. This is optional.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "x-api-key",
"in": "header",
"description": "The API key as defined in Adobe's developer console.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "Authorization",
"in": "header",
"description": "The authorization token with bearer \"token_value\".",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/MergeDataTagsRequest"
}
}
},
"description": "This job request object specifies parameters for retrieving the data merge tags.",
"required": true
},
"responses": {
"202": {
"$ref": "#/components/responses/Accepted"
},
"400": {
"$ref": "#/components/responses/BadParams"
},
"401": {
"$ref": "#/components/responses/Unauthorized"
},
"403": {
"$ref": "#/components/responses/Forbidden"
},
"404": {
"$ref": "#/components/responses/NotFound"
},
"429": {
"$ref": "#/components/responses/TooManyRequests"
},
"500": {
"$ref": "#/components/responses/InternalServerError"
}
}
}
},
"/v3/remap-links": {
"post": {
"summary": "Remap links",
"description": "This service replaces existing file-based links in InDesign documents with AEM URLs. This is particularly useful for customers working with AEM using AEM Asset Link, as it allows designers to work with the output files post-generation by having direct links to AEM URLs.",
"operationId": "remapLinks",
"tags": [
"Remap Links API"
],
"parameters": [
{
"name": "x-gw-ims-org-id",
"in": "header",
"description": "Identifier for the IMS organization as defined in Adobe's developer console. This is optional.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "x-api-key",
"in": "header",
"description": "API key as defined in Adobe's developer console.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "Authorization",
"in": "header",
"description": "Authorization token with bearer `token_value`.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "x-aem-token",
"in": "header",
"description": "Bearer token generated for the AEM technical account without the bearer keyword.",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/RemapLinksRequest"
}
}
},
"description": "Job request object that specifies parameters for remapping links in the InDesign document.",
"required": true
},
"responses": {
"202": {
"$ref": "#/components/responses/Accepted"
},
"400": {
"$ref": "#/components/responses/BadParams"
},
"401": {
"$ref": "#/components/responses/Unauthorized"
},
"403": {
"$ref": "#/components/responses/Forbidden"
},
"404": {
"$ref": "#/components/responses/NotFound"
},
"500": {
"$ref": "#/components/responses/InternalServerError"
}
}
}
},
"/v3/create-rendition": {
"post": {
"summary": "Create JPEG, PNG, or PDF renditions",
"description": "Create a JPEG, PNG, or PDF rendition of a specific InDesign document.
The rendition output MIME types are: `application/pdf` for PDF.
",
"operationId": "renditionJob",
"tags": [
"Rendition API"
],
"parameters": [
{
"name": "x-gw-ims-org-id",
"in": "header",
"description": "This is the identifier for Adobe Identity Management Service (IMS) as defined in Adobe's developer console. This is optional.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "x-api-key",
"in": "header",
"description": "The API key as defined in Adobe's developer console.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "Authorization",
"in": "header",
"description": "The authorization token with bearer \"token_value\".",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CreateRenditionRequest"
}
}
},
"description": "This object specifies parameters for the JPEG, PNG or PDF output.",
"required": true
},
"responses": {
"202": {
"$ref": "#/components/responses/Accepted"
},
"400": {
"$ref": "#/components/responses/BadParams"
},
"401": {
"$ref": "#/components/responses/Unauthorized"
},
"403": {
"$ref": "#/components/responses/Forbidden"
},
"404": {
"$ref": "#/components/responses/NotFound"
},
"429": {
"$ref": "#/components/responses/TooManyRequests"
},
"500": {
"$ref": "#/components/responses/InternalServerError"
}
}
}
},
"/v3/scripts": {
"post": {
"summary": "Submit a Custom Script",
"description": "Submit the custom script bundle. This returns the URL for posting an execution request for the custom script.",
"operationId": "submitCustomScript",
"tags": [
"Custom Scripts API"
],
"parameters": [
{
"name": "x-gw-ims-org-id",
"in": "header",
"description": "This is the identifier for Adobe Identity Management Service (IMS) as defined in Adobe's developer console.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "x-api-key",
"in": "header",
"description": "The API key as defined in Adobe's developer console.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "Authorization",
"in": "header",
"description": "The authorization token with bearer \"token_value\".",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"multipart/form-data": {
"schema": {
"type": "object"
}
}
},
"description": "The custom script bundle, in ZIP format. This package describes the script to the app engine.",
"required": true
},
"responses": {
"202": {
"description": "Status of a job execution.",
"content": {
"application/json": {
"schema": {
"properties": {
"capability": {
"type": "string",
"description": "The name of the custom script, as specified in the custom script manifest."
},
"version": {
"type": "string",
"description": "The version of the custom script, as specified in the custom script manifest."
},
"url": {
"type": "string",
"description": "The URL to submit an execution request for the custom script."
}
}
}
}
}
},
"400": {
"$ref": "#/components/responses/BadParams"
},
"401": {
"$ref": "#/components/responses/Unauthorized"
},
"403": {
"$ref": "#/components/responses/Forbidden"
},
"404": {
"$ref": "#/components/responses/NotFound"
},
"429": {
"$ref": "#/components/responses/TooManyRequests"
},
"500": {
"$ref": "#/components/responses/InternalServerError"
}
}
},
"get": {
"summary": "List custom scripts API",
"description": "Retrieves details of the latest version of all custom scripts registered by the customer. This includes version, script's download link, registration date, and script name. The response is paginated depending on list length.",
"operationId": "listCustomScripts",
"tags": [
"Custom Scripts API"
],
"parameters": [
{
"name": "x-gw-ims-org-id",
"in": "header",
"description": "This is the identifier for Adobe Identity Management Service (IMS) as defined in Adobe's developer console.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "x-api-key",
"in": "header",
"description": "The API key as defined in Adobe's developer console.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "Authorization",
"in": "header",
"description": "The authorization token with bearer \"token_value\".",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "page",
"in": "query",
"description": "Page number for pagination",
"required": false,
"schema": {
"type": "integer",
"default": 1
}
}
],
"responses": {
"200": {
"description": "List of registered custom scripts",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CustomScriptsListResponse"
}
}
}
},
"400": {
"$ref": "#/components/responses/BadParams"
},
"401": {
"$ref": "#/components/responses/Unauthorized"
},
"403": {
"$ref": "#/components/responses/Forbidden"
},
"404": {
"$ref": "#/components/responses/NotFound"
},
"500": {
"$ref": "#/components/responses/InternalServerError"
}
}
}
},
"/v3/{script_id}/{script_name}": {
"post": {
"summary": "Submit a custom script execution request",
"description": "Submit an execution request for a custom script. Define the input assets and parameters the custom script will use when it is executed against the app engine.",
"operationId": "executeCustomScript",
"tags": [
"Custom Scripts API"
],
"parameters": [
{
"name": "x-gw-ims-org-id",
"in": "header",
"description": "This is the identifier for Adobe Identity Management Service (IMS) as defined in Adobe's developer console.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "x-api-key",
"in": "header",
"description": "The API key as defined in Adobe's developer console.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "Authorization",
"in": "header",
"description": "The authorization token with bearer \"token_value\".",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "script_id",
"in": "path",
"description": "script_id as reported in the response to custom script submit request.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "script_name",
"in": "path",
"description": "The name of the custom script, specified in the custom script manifest.",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/BaseJobRequestWithOutput"
}
}
},
"description": "This job request object specifies parameters for the execution of the custom script.",
"required": true
},
"responses": {
"202": {
"$ref": "#/components/responses/Accepted"
},
"400": {
"$ref": "#/components/responses/BadParams"
},
"401": {
"$ref": "#/components/responses/Unauthorized"
},
"403": {
"$ref": "#/components/responses/Forbidden"
},
"404": {
"$ref": "#/components/responses/NotFound"
},
"429": {
"$ref": "#/components/responses/TooManyRequests"
},
"500": {
"$ref": "#/components/responses/InternalServerError"
}
}
}
},
"/v3/scripts/{script_name}": {
"get": {
"summary": "Get custom script details API",
"description": "Retrieves details of a single custom script registered by the customer. This includes version, script's download link, registration date, and script name.",
"operationId": "getCustomScriptDetails",
"tags": [
"Custom Scripts API"
],
"parameters": [
{
"name": "x-gw-ims-org-id",
"in": "header",
"description": "This is the identifier for Adobe Identity Management Service (IMS) as defined in Adobe's developer console.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "x-api-key",
"in": "header",
"description": "The API key as defined in Adobe's developer console.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "Authorization",
"in": "header",
"description": "The authorization token with bearer \"token_value\".",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "script_name",
"in": "path",
"description": "Name of the custom script",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "Details of the custom script",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CustomScriptDetails"
}
}
}
},
"400": {
"$ref": "#/components/responses/BadParams"
},
"401": {
"$ref": "#/components/responses/Unauthorized"
},
"403": {
"$ref": "#/components/responses/Forbidden"
},
"404": {
"$ref": "#/components/responses/NotFound"
},
"500": {
"$ref": "#/components/responses/InternalServerError"
}
}
},
"delete": {
"summary": "Delete custom script API",
"description": "Deletes a single custom script registered by the customer. All versions of that script will be deleted.",
"operationId": "deleteCustomScript",
"tags": [
"Custom Scripts API"
],
"parameters": [
{
"name": "x-gw-ims-org-id",
"in": "header",
"description": "This is the identifier for Adobe Identity Management Service (IMS) as defined in Adobe's developer console.",
"required": false,
"schema": {
"type": "string"
}
},
{
"name": "x-api-key",
"in": "header",
"description": "The API key as defined in Adobe's developer console.",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "Authorization",
"in": "header",
"description": "The authorization token with bearer \"token_value\".",
"required": true,
"schema": {
"type": "string"
}
},
{
"name": "script_name",
"in": "path",
"description": "Name of the custom script to delete",
"required": true,
"schema": {
"type": "string"
}
}
],
"responses": {
"204": {
"description": "Script successfully deleted"
},
"400": {
"$ref": "#/components/responses/BadParams"
},
"401": {
"$ref": "#/components/responses/Unauthorized"
},
"403": {
"$ref": "#/components/responses/Forbidden"
},
"404": {
"$ref": "#/components/responses/NotFound"
},
"500": {
"$ref": "#/components/responses/InternalServerError"
}
}
}
}
},
"components": {
"securitySchemes": {
"ApiKeyAuth": {
"type": "apiKey",
"in": "header",
"name": "x-api-key"
},
"BearerAuth": {
"type": "http",
"scheme": "bearer",
"bearerFormat": "JWT"
}
},
"schemas": {
"HyphenationLanguage": {
"type": "string",
"description": "Supported hyphenation dictionary languages.",
"enum": [
"Arabic",
"Bengali (India)",
"Bulgarian",
"Burmese (Myanmar [Burma])",
"Catalan",
"Croatian",
"Czech",
"Danish",
"Dutch: 2005 Reform",
"Dutch: Old Rules",
"English: Canadian",
"English: UK",
"English: USA",
"English: USA Legal",
"English: USA Medical",
"Estonian",
"Finnish",
"French",
"French: Canadian",
"German: 1996 Reform",
"German: 2006 Reform",
"German: Austria 2006 Reform",
"German: Old Rules",
"German: Swiss",
"German: Swiss 2006 Reform",
"Greek",
"Gujarati (India)",
"Hebrew",
"Hindi (India)",
"Hungarian",
"Indonesian (Indonesia)",
"Italian",
"Kannada (India)",
"Khmer (Cambodia)",
"Lao (Laos)",
"Latvian",
"Lithuanian",
"Malayalam (India)",
"Marathi (India)",
"Norwegian: Bokmål",
"Norwegian: Nynorsk",
"Oriya (India)",
"Polish",
"Portuguese",
"Portuguese: Brazilian",
"Portuguese: Orthographic Agreement",
"Punjabi (India)",
"Romanian",
"Russian",
"Sinhala (Sri Lanka)",
"Slovak",
"Slovenian",
"Spanish",
"Swedish",
"Tamil (India)",
"Telugu (India)",
"Thai",
"Turkish",
"Ukrainian",
"Vietnamese"
]
},
"InputAsset": {
"type": "object",
"description": "The URL where the asset will be fetched.",
"required": [
"source"
],
"properties": {
"source": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "The URL of the asset."
},
"storageType": {
"type": "string",
"description": "This is optional parameter, however IT IS RECOMMENDED to provide this information.",
"enum": [
"Azure",
"Dropbox",
"AWS"
]
}
}
},
"destination": {
"type": "string",
"description": "This provides a path relative to a temporary base directory (working directory) where the resource would be downloaded. This would be used to identify the assets within the parameters. It cannot go up using '..' or '/'. Should be a valid file name."
}
}
},
"BaseJobRequest": {
"description": "The base job request for any job.",
"required": [
"assets"
],
"properties": {
"assets": {
"type": "array",
"items": {
"$ref": "#/components/schemas/InputAsset"
},
"description": "Information about the assets, which will be used to process the job."
},
"params": {
"type": "object",
"properties": {
"generalSettings": {
"description": "General settings.",
"type": "object",
"properties": {
"fonts": {
"description": "Settings related to fonts.",
"type": "object",
"properties": {
"fontsDirectories": {
"description": "This lists the font directories for the input InDesign documents. \"Document Fonts\" in parallel to the document will continue to work even without specifying them.
If none are specified, a temporary base directory (working directory) will be considered as a font directory.",
"type": "array",
"items": {
"type": "string",
"description": "This provides a path to a directory relative to a temporary base directory (working directory) where the fonts can be found. It cannot go up using '..' or '/'. Should be a valid path. For specifying a working directory, mention '.'."
}
}
}
},
"links": {
"description": "Settings related to links.",
"type": "object",
"properties": {
"replaceLinks": {
"type": "array",
"items": {
"type": "object",
"required": [
"targetDocument",
"mapping"
],
"properties": {
"targetDocument": {
"description": "The document in which the relinking is to be done.",
"type": "string"
},
"mapping": {
"type": "array",
"items": {
"type": "object",
"required": [
"newAssetRelativePath"
],
"properties": {
"currentURI": {
"type": "string",
"description": "The existing URI of the link that needs relinking. If multiple links with this URI are found, all will be relinked. If `linkID is provided, this attribute will be ignored. Either `currentURI` or `linkID` should be present."
},
"linkID": {
"type": "integer",
"description": "The ID of the link which is to be relinked. If `currentURI` is also provided, it will be ignored. Either `currentURI` or `linkID` should be present."
},
"newAssetRelativePath": {
"type": "string",
"description": "This provides a path relative to a temporary base directory (working directory) where the asset to be linked to can be found. It cannot go up using '..' or '/'. Should be a valid file name."
}
}
}
}
}
}
}
}
},
"appLogs": {
"description": "Describes parameters regarding application logs.",
"type": "object",
"properties": {
"logsRelativePath": {
"type": "string",
"description": "This provides a path to a file, relative to the temporary base directory (working directory). This file is where the application's logs are to be dumped."
}
}
}
}
}
}
}
}
},
"OutputAsset": {
"description": "The URL where the output assets are to be posted after the job is processed.",
"type": "object",
"required": [
"destination",
"source"
],
"properties": {
"destination": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "The URL of the asset."
},
"storageType": {
"type": "string",
"description": "This is an optional parameter, however IT IS RECOMMENDED to provide this information.",
"enum": [
"Azure",
"Dropbox",
"AWS"
]
}
}
},
"source": {
"type": "string",
"description": "This provides a path relative of the output where the resource would be generated. It cannot go up using '..' or '/'. Should be a valid file name."
}
}
},
"BaseJobRequestWithOutput": {
"allOf": [
{
"$ref": "#/components/schemas/BaseJobRequest"
},
{
"description": "The base job request for any job with the option to specify output URLs.",
"type": "object",
"properties": {
"outputs": {
"type": "array",
"items": {
"$ref": "#/components/schemas/OutputAsset"
}
}
}
}
]
},
"MergeDataRequest": {
"allOf": [
{
"$ref": "#/components/schemas/BaseJobRequestWithOutput"
},
{
"description": "Inputs for the data merge request.",
"type": "object",
"required": [
"params"
],
"properties": {
"params": {
"type": "object",
"required": [
"targetDocument",
"dataSource"
],
"properties": {
"targetDocument": {
"description": "The tagged document to be used as the template for merging.",
"type": "string"
},
"dataSource": {
"description": "The data source files to be used.",
"type": "string"
},
"outputMediaType": {
"description": "The type of output.",
"type": "string",
"enum": [
"image/jpeg",
"image/png",
"application/pdf",
"application/x-indesign"
],
"default": "application/x-indesign"
},
"exportSettings": {
"type": "object",
"description": "The settings corresponding to the output format.",
"properties": {
"jobOptionsFile": {
"type": "string",
"description": "The file, which will be used as the PDF creation settings file during the export. This will take precedence over the `pdfPreset` attribute.
Only relevant if the `outputMediaType` is `application/pdf`."
},
"pdfPreset": {
"type": "string",
"description": "The PDF export style to be used. This is relevant if `outputMediaType` is `application/pdf`.",
"default": "High Quality Print",
"enum": [
"High Quality Print",
"PDF/X-1a:2001",
"PDF/X-3:2002",
"PDF/X-4:2008",
"Press Quality",
"Smallest File Size"
]
},
"quality": {
"type": "string",
"description": "Defines the quality of the output for JPEG and PNG formats.",
"default": "medium",
"enum": [
"low",
"medium",
"high",
"maximum"
]
},
"linkImages": {
"description": "If `true`, links images to the target document. If `false`, embeds linked images already referred in the target document. Only relevant if `outputMediaType` is `application/x-indesign`.",
"type": "boolean",
"default": false
}
}
},
"recordRange": {
"description": "The ranges of records to process for this job. Value can be `All`, along with numeral ranges. For example, '1-2, 5'.",
"type": "string",
"default": "All"
},
"allowMultipleRecordsPerPage": {
"description": "If `true`, will show as many records as will fit on a page.",
"type": "boolean",
"default": false
},
"multipleRecordLayoutOptions": {
"description": "The options to be used when `allowMultipleRecordsPerPage` is set to `true`.",
"type": "object",
"properties": {
"arrangeBy": {
"description": "The order that records will be arranged in the target document.\n* `rows_first` - Arranges records by row.\n* `columns_first` - Arranges records by column.\n",
"type": "string",
"default": "rows_first",
"enum": [
"rows_first",
"columns_first"
]
},
"bottomMargin": {
"description": "The offset value of the bottom margin in the target document. The values can be specified like `1 pt`, `1 pica`, `1`, etc. If a number is mentioned in the string, it will be used as a value in pica.",
"type": "string"
},
"topMargin": {
"description": "The offset value of the top margin in the target document. The values can be specified like `1 pt`, `1 pica`, `1`, etc. If a number is mentioned in the string, it will be used as a value in pica.",
"type": "string"
},
"leftMargin": {
"description": "The offset value of the left margin in the target document. The values can be specified like `1 pt`, `1 pica`, `1`, etc. If a number is mentioned in the string, it will be used as a value in pica.",
"type": "string"
},
"rightMargin": {
"description": "The offset value of the right margin in the target document. The values can be specified like `1 pt`, `1 pica`, `1`, etc. If a number is mentioned in the string, it will be used as a value in pica.",
"type": "string"
},
"columnSpacing": {
"description": "The amount of spacing between columns of records in the target document. The values can be specified like `1 pt`, `1 pica`, `1`, etc. If a number is mentioned in the string, it will be used as a value in pica.",
"type": "string"
},
"rowSpacing": {
"description": "The amount of spacing between rows of records in the target document. The values can be specified like `1 pt`, `1 pica`, `1`, etc. If a number is mentioned in the string, it will be used as a value in pica.",
"type": "string"
}
}
},
"imagePlacementOptions": {
"description": "These are the options for image placement which will be used while merging images in the document.",
"type": "object",
"properties": {
"centerImage": {
"description": "If true, this centers the image in the frame while preserving the frame size as content size and proportions. If the content is larger than the frame, content around the edges is obscured by the bounding box of the frame.
This won't work when `fittingOption` is `Content_Aware_Fit`.",
"type": "boolean",
"default": false
},
"fittingOption": {
"description": "The method of fitting content in a frame.\n* `content_aware_fit` - Selects best crop region of the content for the frame based on Adobe Sensei. This preserves frame size but it might scale the content size. If this fitting is set, the `centerImage` property is turned-off.\n* `fill_proportional` - Resizes content to fill the frame while preserving the proportions of the content. If the content and frame have different proportions, some of the content is obscured by the bounding box of the frame.\n* `fit_content_to_frame` - Resizes content to fit the frame. Content that is a different size than the frame appears stretched or squeezed.\n* `fit_frame_to_content` - Resizes the frame so it fits the content.\n* `honor_existing_style` - Applies the frame fitting based on existing settings applied on the original frame.\n* `preserve_sizes` - Preserves the original sizes of the frame and the content. Content that is larger than the frame is obscured around the edges.\n* `proportional` - Resizes content to fit the frame while preserving content proportions. If the content and frame have different proportions, an empty space occurs in the frame.\n",
"type": "string",
"default":"proportional",
"enum": [
"content_aware_fit",
"fill_proportional",
"fit_content_to_frame",
"fit_frame_to_content",
"honor_existing_style",
"preserve_sizes",
"proportional"
]
},
"linkImages": {
"description": "This applies to the images being brought in the document while merging. If true, this links images to the target document. If false, it embeds images in the target document.",
"type": "boolean",
"default": false
}
}
},
"hyphenationSettings": {
"description": "Hyphenation settings to control word breaking and hyphenation behavior during merge.",
"type": "object",
"properties": {
"afterFirst": {
"type": "integer",
"description": "Minimum number of characters at the start of a word before a hyphen may be inserted."
},
"beforeLast": {
"type": "integer",
"description": "Minimum number of characters at the end of a word after a hyphen."
},
"wordsLongerThan": {
"type": "integer",
"description": "Minimum word length for hyphenation to apply."
},
"ladderLimit": {
"type": "integer",
"description": "Maximum allowed consecutive hyphenated lines."
},
"zone": {
"type": "number",
"description": "Whitespace ratio allowed at the end of a line before hyphenation begins (0–1)."
},
"capitalizedWords": {
"type": "boolean",
"description": "If true, allows hyphenation of capitalized words."
},
"lastWord": {
"type": "boolean",
"description": "If true, allows hyphenation of the last word in a paragraph."
},
"acrossColumns": {
"type": "boolean",
"description": "If true, allows hyphenation across columns."
},
"dictionarySettings": {
"type": "array",
"description": "Special hyphenation definitions by language.",
"items": {
"type": "object",
"required": [
"language",
"wordList"
],
"properties": {
"language": {
"$ref": "#/components/schemas/HyphenationLanguage"
},
"wordList": {
"type": "array",
"description": "List of special hyphenation definitions (use `~` to mark break points, e.g., `Know~how`, `check~in`. Put `~` at the beginning of the word to exclude it from hyphenation, e.g., `~Wallstreet`, `~Starbucks`).",
"items": {
"type": "string"
}
}
}
}
}
}
},
"pagesPerDocument": {
"description": "The maximum number of pages per document.",
"type": "integer",
"default": "By default this would not be applicable."
},
"removeBlankLines": {
"description": "If true, removes blank lines caused by empty fields.",
"type": "boolean",
"default": false
},
"convertUrlToHyperlink": {
"description": "If true, all URLs in the merged document are converted into hyperlinks.",
"type": "boolean",
"default": true
},
"outputFileBaseString": {
"type": "string",
"description": "The name of the output file.",
"default": "It is derived from the original document filename."
},
"outputFolderPath": {
"type": "string",
"description": "The path of the output folder.",
"default": "A unique temporary folder name would be created."
}
}
}
}
}
]
},
"Error": {
"type": "object",
"properties": {
"message": {
"type": "string"
},
"error_code": {
"type": "string"
}
},
"required": [
"message",
"error_code"
]
},
"MergeDataTagsRequest": {
"allOf": [
{
"$ref": "#/components/schemas/BaseJobRequest"
},
{
"description": "Filters according to which the information related to data merge tags would be retrieved.",
"type": "object",
"required": [
"params"
],
"properties": {
"params": {
"type": "object",
"required": [
"targetDocument"
],
"properties": {
"targetDocument": {
"description": "The target document that will have its tags extracted.",
"type": "string"
},
"dataSource": {
"description": "The data source file to be used for extracting and matching the tags.",
"type": "string"
},
"filter": {
"description": "The filter applied for tags. Accepts multiple values.",
"type": "array",
"example": "text, image",
"default": "all",
"items": {
"type": "string",
"enum": [
"all",
"text",
"image",
"qr"
]
}
},
"includePageItemIdentifiers": {
"type": "boolean",
"description": "If true, the information for associated page items is added to the tags extracted from the document.",
"default": false
}
}
}
}
}
]
},
"RemapLinksRequest": {
"description": "Inputs for the link remapping request.",
"type": "object",
"required": [
"params",
"assets"
],
"properties": {
"assets": {
"type": "array",
"items": {
"$ref": "#/components/schemas/InputAsset"
}
},
"params": {
"type": "object",
"required": [
"targetDocument",
"dataSource"
],
"properties": {
"targetDocument": {
"description": "The InDesign document in which links need to be remapped.",
"type": "string"
},
"dataSource": {
"description": "Array of link mappings containing source and destination URIs.",
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"required": [
"sourceURI",
"destinationURI"
],
"properties": {
"sourceURI": {
"type": "string",
"description": "File path/resource URI for the existing link that needs to be remapped."
},
"destinationURI": {
"type": "string",
"description": "AEM URI that will replace the existing link."
}
}
}
}
}
},
"outputs": {
"type": "array",
"items": {
"$ref": "#/components/schemas/OutputAsset"
}
}
}
},
"CreateRenditionRequest": {
"allOf": [
{
"$ref": "#/components/schemas/BaseJobRequestWithOutput"
},
{
"description": "Inputs and properties with which the job should be processed.",
"type": "object",
"required": [
"params"
],
"properties": {
"params": {
"type": "object",
"required": [
"targetDocuments",
"outputMediaType"
],
"properties": {
"targetDocuments": {
"description": "The documents that will be processed and rendered. Currently, only one document at a time is supported.",
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"maxItems": 1
},
"outputMediaType": {
"description": "The MIME type output of the rendered file.",
"type": "string",
"enum": [
"image/jpeg",
"image/png",
"application/pdf"
]
},
"exportingSpread": {
"type": "boolean",
"default": false,
"description": "Specify `true` if you consider range as spread numbers. Use `false` if you treat range as pages."
},
"pageRange": {
"type": "string",
"default": "All",
"description": "The page ranges, based on the index of the page within the document. The value can be 'All', as well as numeral ranges. If `exportingSpread` is true, this range would represent spread indices in the document."
},
"quality": {
"type": "string",
"description": "Defines the quality of the output.",
"default": "medium",
"enum": [
"low",
"medium",
"high",
"maximum"
]
},
"renderingStyle": {
"type": "string",
"description": "Specifies formatting options for the converted JPEG images.",
"default": "baseline_encoding",
"enum": [
"baseline_encoding",
"progressive_encoding"
]
},
"resolution": {
"type": "integer",
"default": 72,
"description": "Specifies the resolution of the final image.",
"minimum": 1,
"maximum": 2400
},
"colorSpace": {
"type": "string",
"description": "Specifies formatting options for converted JPEG images.",
"default": "rgb",
"enum": [
"rgb",
"cmyk",
"gray"
]
},
"embedColorProfile": {
"type": "boolean",
"default": true,
"description": "Specify `true` to embed the color profile. Otherwise, use `false`."
},
"antiAlias": {
"type": "boolean",
"default": true,
"description": "If `true`, anti-aliasing is used for text and vectors during export."
},
"simulateOverprint": {
"type": "boolean",
"default": false,
"description": "If `true`, this simulates the effects of overprinting spot and processes colors in the same way they would occur with a print."
},
"useDocumentBleeds": {
"type": "boolean",
"default": false,
"description": "If `true`, the document's bleed settings are used in the exported JPEG."
},
"colorSettingsFile": {
"type": "string",
"description": "This is the color settings file to be used for generating a rendition."
},
"transparentBackground": {
"type": "boolean",
"default": false,
"description": "If `true`, this uses a transparent background for the exported PNG. This is valid only for PNG renditions."
},
"createSeparateFiles": {
"type": "boolean",
"default": false,
"description": "Specify `true` to create separate PDF files for all the specified pages/spreads. This is applicable only in case of PDF rendition."
},
"optimizeForFastWebView": {
"type": "boolean",
"default": true,
"description": "Specify `true` to optimize the PDF for faster web viewing. This is applicable only in case of PDF rendition."
},
"embedPageThumbnails": {
"type": "boolean",
"default": false,
"description": "Specify `true` for embedding page thumbnails. This is applicable only in case of PDF rendition."
},
"includeBookmarks": {
"type": "boolean",
"default": false,
"description": "If `true`, this displays bookmarks and table-of-contents entries as links in the bookmarks pane of the PDF document. If `false`, bookmarks are not exported. This is applicable only in case of PDF rendition."
},
"includeHyperlinks": {
"type": "boolean",
"default": false,
"description": "If `true`, this includes the hyperlinks when exporting the document. This is applicable only in case of PDF rendition."
},
"exportNonprintingObjects": {
"type": "boolean",
"default": false,
"description": "If `true`, this makes non-printing objects visible in the PDF document. This is applicable only in case of PDF rendition."
},
"exportGuidesAndGrids": {
"type": "boolean",
"default": false,
"description": "If `true`, this includes visible guides and baseline grids in the PDF. This is applicable only in case of PDF rendition. document."
},
"createTaggedPDF": {
"type": "boolean",
"default": true,
"description": "If `true`, this creates a tagged PDF file. This is applicable only in case of PDF rendition."
},
"includeInteractiveElements": {
"type": "string",
"description": "Specifies the option to draw interactive elements. This is applicable only in case of PDF rendition.",
"default": "do_not_include",
"enum": [
"do_not_include",
"appearance_only"
]
},
"exportWhichLayers": {
"type": "string",
"description": "This indicates the image layers to be exported. This is applicable only in case of PDF rendition.",
"default": "export_all_layers",
"enum": [
"export_all_layers",
"export_visible_layers",
"export_visible_printable_layers"
]
},
"jobOptionsFile": {
"type": "string",
"description": "This is the file used as the PDF creation settings file during the export. This will take precedence over the `pdfPreset` attribute. This is applicable only in case of PDF rendition."
},
"pdfPreset": {
"type": "string",
"description": "The export style to be used. This is applicable only in case of PDF rendition.",
"default": "High Quality Print",
"enum": [
"High Quality Print",
"PDF/X-1a:2001",
"PDF/X-3:2002",
"PDF/X-4:2008",
"Press Quality",
"Smallest File Size"
]
},
"outputFileBaseString": {
"type": "string",
"description": "The name of the output file.",
"default": "It is derived from the original document filename."
},
"outputFolderPath": {
"type": "string",
"description": "The path of the output folder.",
"default": "A unique temporary folder name would be created."
}
}
}
}
}
]
},
"CustomScriptsListResponse": {
"type": "object",
"description": "Response containing list of registered custom scripts",
"properties": {
"capabilities": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CustomScriptDetails"
}
},
"paging": {
"type": "object",
"properties": {
"nextUrl": {
"type": "string",
"description": "URL for the next page of results",
"example": "https://indesign.adobe.io/api/v3/scripts?page=2"
}
}
}
}
},
"CustomScriptDetails": {
"type": "object",
"description": "Details of a custom script",
"properties": {
"version": {
"type": "string",
"description": "Version of the custom script",
"example": "1.0.2"
},
"url": {
"type": "string",
"description": "URL that was generated during registration",
"example": "https://indesign.adobe.io/v3/634aaf2dd50c8d198/idml/export"
},
"downloadurl": {
"type": "string",
"description": "Pre-signed URL for downloading the script (valid for 30 minutes)",
"example": "https://example.com/download/script.zip"
},
"createdDate": {
"type": "string",
"format": "date-time",
"description": "Registration date of the script",
"example": "2025-07-03T08:44:26.051Z"
},
"scriptName": {
"type": "string",
"description": "Name of the custom script",
"example": "3p-testing/test1"
}
}
}
},
"responses": {
"Accepted": {
"description": "The job has been accepted for processing.",
"content": {
"application/json": {
"schema": {
"properties": {
"jobId": {
"type": "string",
"description": "The job ID."
},
"statusUrl": {
"type": "string",
"description": "The status URL."
}
}
}
}
},
"headers": {
"link": {
"schema": {
"type": "string"
},
"description": "The status URL for a retry."
},
"retry-after": {
"schema": {
"type": "integer"
},
"description": "The number of seconds until the user should try again."
},
"Content-Type": {
"schema": {
"type": "string"
},
"description": "The type of content that is returned (e.g., `application/json`)."
},
"Content-Length": {
"schema": {
"type": "integer"
},
"description": "The length of the response content."
},
"Access-Control-Allow-Origin": {
"schema": {
"type": "string"
},
"description": "The Cross Origin Resource Sharing (CORS) header."
},
"Access-Control-Allow-Methods": {
"schema": {
"type": "string"
},
"description": "This indicates what HTTP methods are allowed."
},
"Access-Control-Allow-Headers": {
"schema": {
"type": "string"
},
"description": "This indicates which HTTP headers can be used during the actual request."
},
"Access-Control-Allow-Credentials": {
"schema": {
"type": "string"
},
"description": "This header is used by servers to indicate that the client shall share HTTP responses."
},
"Access-Control-Max-Age": {
"schema": {
"type": "integer"
},
"description": "This indicates how long the results of a preflight request can be cached."
}
}
},
"BadParams": {
"description": "Bad Parameter",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
},
"headers": {
"Content-Type": {
"schema": {
"type": "string"
},
"description": "The type of content returned (e.g., `application/json`)."
},
"Content-Length": {
"schema": {
"type": "integer"
},
"description": "The length of the response content."
},
"Access-Control-Allow-Origin": {
"schema": {
"type": "string"
},
"description": "The Cross Origin Resource Sharing (CORS) header."
},
"Access-Control-Allow-Methods": {
"schema": {
"type": "string"
},
"description": "This header indicates what HTTP methods are allowed."
},
"Access-Control-Allow-Headers": {
"schema": {
"type": "string"
},
"description": "This indicates which HTTP headers can be used during the actual request."
},
"Access-Control-Allow-Credentials": {
"schema": {
"type": "string"
},
"description": "This header is used by servers to indicate that the client shall share HTTP responses."
},
"Access-Control-Max-Age": {
"schema": {
"type": "integer"
},
"description": "This indicates how long the results of a preflight request can be cached."
}
}
},
"Unauthorized": {
"description": "Unauthorized",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
},
"headers": {
"Content-Type": {
"schema": {
"type": "string"
},
"description": "The type of content returned (e.g., `application/json`)."
},
"Content-Length": {
"schema": {
"type": "integer"
},
"description": "The length of the response content."
},
"Access-Control-Allow-Origin": {
"schema": {
"type": "string"
},
"description": "The Cross Origin Resource Sharing (CORS) header."
},
"Access-Control-Allow-Methods": {
"schema": {
"type": "string"
},
"description": "This indicates what HTTP methods are allowed."
},
"Access-Control-Allow-Headers": {
"schema": {
"type": "string"
},
"description": "This indicates which HTTP headers can be used during the actual request."
},
"Access-Control-Allow-Credentials": {
"schema": {
"type": "string"
},
"description": "This header is used by servers to indicate that the client shall share HTTP responses."
},
"Access-Control-Max-Age": {
"schema": {
"type": "integer"
},
"description": "This indicates how long the results of a preflight request can be cached."
}
}
},
"Forbidden": {
"description": "Forbidden",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
},
"headers": {
"Content-Type": {
"schema": {
"type": "string"
},
"description": "The type of content returned (e.g., `application/json`)."
},
"Content-Length": {
"schema": {
"type": "integer"
},
"description": "The length of the response content."
},
"Access-Control-Allow-Origin": {
"schema": {
"type": "string"
},
"description": "The Cross Origin Resource Sharing (CORS) header."
},
"Access-Control-Allow-Methods": {
"schema": {
"type": "string"
},
"description": "This header indicates what HTTP methods are allowed."
},
"Access-Control-Allow-Headers": {
"schema": {
"type": "string"
},
"description": "This indicates which HTTP headers can be used during the actual request."
},
"Access-Control-Allow-Credentials": {
"schema": {
"type": "string"
},
"description": "This header is used by servers to indicate that the client shall share HTTP responses."
},
"Access-Control-Max-Age": {
"schema": {
"type": "integer"
},
"description": "This indicates how long the results of a preflight request can be cached."
}
}
},
"NotFound": {
"description": "Not Found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
},
"headers": {
"Content-Type": {
"schema": {
"type": "string"
},
"description": "The type of content returned (e.g., `application/json`)."
},
"Content-Length": {
"schema": {
"type": "integer"
},
"description": "The length of the response content."
},
"Access-Control-Allow-Origin": {
"schema": {
"type": "string"
},
"description": "The Cross Origin Resource Sharing (CORS) header."
},
"Access-Control-Allow-Methods": {
"schema": {
"type": "string"
},
"description": "This header indicates what HTTP methods are allowed."
},
"Access-Control-Allow-Headers": {
"schema": {
"type": "string"
},
"description": "This indicates which HTTP headers can be used during the actual request."
},
"Access-Control-Allow-Credentials": {
"schema": {
"type": "string"
},
"description": "This header is used by servers to indicate that the client shall share HTTP responses."
},
"Access-Control-Max-Age": {
"schema": {
"type": "integer"
},
"description": "This indicates how long the results of a preflight request can be cached."
}
}
},
"InternalServerError": {
"description": "Internal Server Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
},
"headers": {
"Content-Type": {
"schema": {
"type": "string"
},
"description": "The type of content returned (e.g., `application/json`)."
},
"Content-Length": {
"schema": {
"type": "integer"
},
"description": "The length of the response content."
},
"Access-Control-Allow-Origin": {
"schema": {
"type": "string"
},
"description": "The Cross Origin Resource Sharing (CORS) header."
},
"Access-Control-Allow-Methods": {
"schema": {
"type": "string"
},
"description": "This header indicates what HTTP methods are allowed."
},
"Access-Control-Allow-Headers": {
"schema": {
"type": "string"
},
"description": "This indicates which HTTP headers can be used during the actual request."
},
"Access-Control-Allow-Credentials": {
"schema": {
"type": "string"
},
"description": "This header is used by servers to indicate that the client shall share HTTP responses."
},
"Access-Control-Max-Age": {
"schema": {
"type": "integer"
},
"description": "This indicates how long the results of a preflight request can be cached."
}
}
},
"TooManyRequests": {
"description": "Too Many Requests",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
},
"headers": {
"Content-Type": {
"schema": {
"type": "string"
},
"description": "The format of the content returned (e.g., `application/json`)."
},
"Content-Length": {
"schema": {
"type": "integer"
},
"description": "The length of the response content."
},
"Retry-After": {
"schema": {
"type": "integer"
},
"description": "The number of seconds until the user should try again."
},
"Access-Control-Allow-Origin": {
"schema": {
"type": "string"
},
"description": "The Cross Origin Resource Sharing (CORS) header."
},
"Access-Control-Allow-Methods": {
"schema": {
"type": "string"
},
"description": "This indicates what HTTP methods are allowed."
},
"Access-Control-Allow-Headers": {
"schema": {
"type": "string"
},
"description": "This indicates which HTTP headers can be used during the actual request."
},
"Access-Control-Allow-Credentials": {
"schema": {
"type": "string"
},
"description": "This header is used by servers to indicate that the client shall share HTTP responses."
},
"Access-Control-Max-Age": {
"schema": {
"type": "integer"
},
"description": "This indicates how long the results of a preflight request can be cached."
}
}
}
}
}
}