Changelog

Release notes for the Adobe Express API, with the newest release first.<br><br><a href="https://raw.githubusercontent.com/AdobeDocs/ffs-express-api/refs/heads/main/src/pages/feed.xml" style="display: inline-flex; align-items: center; gap: 6px;"><svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" width="20" height="20"><circle cx="6.18" cy="17.82" r="2.18" fill="#eb1000"/><path d="M4 4.44v2.83c7.03 0 12.73 5.7 12.73 12.73h2.83c0-8.59-6.97-15.56-15.56-15.56zm0 5.66v2.83c3.9 0 7.07 3.17 7.07 7.07h2.83c0-5.47-4.43-9.9-9.9-9.9z" fill="#eb1000"/></svg><span>Subscribe via RSS</span></a>

2026-10-16

Changed

• Webhook support has evolved, moving from status-based to operation-based events. Please see the updated guide for details.

data-variant=warning

data-slots=text

2026-09-11

Added

• Webhook support: Register a webhook to receive real-time job status notifications for Create Variation (POST /beta/create-variation) and Export Rendition (POST /beta/export-rendition). See the new Handle Webhook Events guide.

2026-08-13

Added

• 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

Deprecated

• 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.

2026-04-24

Added

• 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.

2026-02-19

Added

• 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.

2025-07-29

Added

• 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

Technical Details

• 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

2025-04-30

Added

• 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.

2025-03-21

Added

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).