Changelog

A list of updates to Adobe Express API.

2026-08-13

Create Variation API (beta): New POST /beta/create-variation endpoint that creates a document variation and returns one or more outputs in a single asynchronous call.
- Typed element mappings: replace text, image, and video elements via textMappings, imageMappings, and videoMappings.
- Per-page overrides: apply different values to specific pages with pageOverrides.
- Multiple output formats in one request: request any combination of image, document, pdf, and video outputs from the same variation, each with its own page range and format options.
- Returns a jobId and statusUrl; poll GET /status/{jobId} for results. Rate-limited to 5 requests per minute (rpm) by default during beta.
- See the new Create Document Variations guide and the API reference.

data-variant=warning

data-slots=text

Please note that the Create Variation API is currently in beta and may be subject to changes before general availability.

Generate Variation: The Generate Variation (POST /beta/generate-variation) endpoint is deprecated in favor of Create Variation, which folds document creation and rendition export into a single call. It remains available during beta; plan to migrate to create-variation ahead of general availability.

Beta release of the Express API: API reference, guides, tutorials, FAQ, and error logging now reflect the beta endpoints at /beta/ (tagged-documents, generate-variation, export-rendition, status).
Consolidated OpenAPI specification: All endpoints are now documented from a single bundled ffs-express-api.json spec for consistent schemas and examples across the API reference.
Getting Started section: New top-level Getting Started navigation tab consolidating onboarding content.
- Getting Started landing page with authentication (S2S), credentials creation, and usage guidance.
- Technical Usage Notes page covering limits, quotas, and operational guidance.
Guides section now includes an Express API Quickstart, with clearer separation between How-Tos and Tutorials in the side navigation.

PDF Export Support: Export renditions now include application/pdf format with standard and print options.
- Added PDF-specific options for pdfType, downloadIndividualPdfFiles, and config (accessibility and print settings).
- Updated Export Rendition documentation and guides to reflect PDF format support and page range usage.
- Updated landing pages to list PDF among supported rendition formats.

Comprehensive Video Capabilities: Full video support across all Adobe Express API endpoints
- Added video as a supported tag type in TaggedElementType schemas across all API specifications
- Enhanced RenditionFormat to include video/mp4 format alongside existing image formats
- Added VideoRenditionFormat schema with MP4 support
- Video renditions support sizes from 146px to 4096px with both upscaling and downscaling
- Video rendition URLs are valid for 24 hours (vs 4 hours for images)
Enhanced Tag Mapping Support: Video elements can now be mapped using pre-signed URLs in variation generation
- Updated tagMappings descriptions to include video element support
- Added video tag examples throughout documentation and code snippets
Updated Documentation: Comprehensive updates to guides and tutorials
- Enhanced Generate Variations guide with video tag mapping examples
- Updated Export Document guide with video format constraints
- Added video examples to End-to-End Workflow guide
- Updated FAQ and Known Issues sections with video tag mapping examples
- Enhanced error logging documentation to include video format validation
API Specification Updates: All OpenAPI specifications now include consistent video support
- beta-generate-variation.json: Video tag type and mapping support
- beta-tagged-documents.json and beta-tagged-documents-documentId.json: Video tag type support
- beta-export-rendition.json: Already had comprehensive video support

Video renditions follow the same pre-signed URL requirements as images (AWS, Dropbox, Azure domains)
Video tag mappings work seamlessly with existing text and image tag workflows
All code examples and tutorials updated to demonstrate multi-media tag mapping capabilities

MP4 format support for the Export Rendition API. You can now export video renditions for pages containing timelines.
See the Export Rendition API documentation for more details on supported formats and usage.

We're excited to announce the release of our Express API

The Express API currently has 5 API endpoints briefly described below:

Tagged documents API: Retrieve all tagged documents accessible to the user.
Tagged document details API: Retrieve the details of a tagged document.
Generate variation API: Generate variations using a tagged document.
Export rendition API: Export a PNG image rendition of a tagged document.
Status API: Retrieve the status of a job (e.g., the job returned in the response from the generate variation or export rendition API).