Data Merge & Create Rendition

Data merge

Changed on

This endpoint allows you to merge variable data from a CSV file with an Adobe Illustrator template. The request is processed asynchronously and the status of the job can be checked using the status URL provided in the response. The output is provided as an array of individual files, one for each row in the CSV data. If some rows succeed and others fail or require rerun, the job completes with status partially_succeeded when you poll the status endpoint; that status applies only to Data Merge jobs.

post/v1/merge-data

Request

  • Base URL: https://illustrator-api.adobe.io
  • URL: https://illustrator-api.adobe.io/v1/merge-data
  • Auth: HTTP bearer and API key in header x-api-key

Request body

Example request

{
  "data": {
    "source": {
      "url": "https://your-bucket.s3.amazonaws.com/your-file.csv"
    }
  },
  "template": {
    "source": {
      "url": "https://your-bucket.s3.amazonaws.com/your-file.csv"
    }
  },
  "fontFiles": [
    {
      "source": {
        "url": "https://your-bucket.s3.amazonaws.com/your-file.csv"
      }
    }
  ],
  "settings": {
    "fontSettings": {
      "minFontSize": 8,
      "fallBackFont": "Roboto-Thin"
    }
  },
  "output": {
    "fileName": "your-output.pdf"
  }
}

Response

Accepted

jobIdstring required

The job ID.

statusUrlstring required

The status URL.

Example response

{
  "jobId": "f246bc8a-45ef-4cdc-8217-6c1ab74c5dc4",
  "statusUrl": "https://illustrator-api-beta.adobe.io/beta/status/f246bc8a-45ef-4cdc-8217-6c1ab74c5dc4"
}

Changes