Migration to v2 Overview

This overview helps you understand the general changes and how to prepare for the migration from the legacy v1 Photoshop and Lightroom APIs to the new unified v2 API.

What's different?

The Photoshop and Lightroom API v2 represents a significant improvement over v1.

For all the details about the new architecture and powerful new service improvements, see the Key Improvements and Architecture with v2 page.

Unified architecture

All Photoshop and Lightroom operations are now served from a single, unified API
Consistent request/response patterns across all endpoints
Simplified authentication and error handling

Improved capabilities

Combine multiple operations in a single API call
More flexible output options with embedded, hosted, and external storage
Enhanced layer manipulation and document editing
Support for custom actions and scripts

Better performance

Optimized processing pipeline
Reduced latency for common operations
More efficient resource utilization

What are the breaking changes?

The v2 API introduces some breaking changes:

Base URL change

Photoshop API v2 uses photoshop-api*.adobe.io domains instead of image*.adobe.io.

Request payload structure changes

Field renaming and restructuring across all endpoints.

Output format changes

JPEG quality now uses string enums instead of numbers (7 is now "maximum").
PNG compression is expanded from 3 to 10 levels.

Response format modifications

Updated status and result structures.

Different output configuration options - New destination object structure, with an optional storageType.

New required fields in some cases
Required fields now include mediaType (was type) and destination (was href).

Deprecated fields

The storage field for AWS S3 is deprecated.
Numeric quality values for JPEG are no longer supported.

Review the detailed migration guides for each endpoint type to understand the specific impacts to your integration and how to migrate.

What about authentication?

Authentication remains unchanged. Continue using your existing OAuth Server-to-Server credentials with the new v2 endpoints. See the Authentication Guide for more information.

How should I begin migrating?

Read the Kye Improvements and Architecture with v2 to understand the architectural changes
Review storage options in the enhanced storage solutions guide
Choose your migration path based on the endpoints you currently use (see the reference table below):
- Lightroom Operations:
  - Edit Operations - Lightroom editing operations (autoTone, presets, XMP, etc.)
- Document Operations:
  - Format Conversion - Converting PSDs to other formats (renditionCreate) and PSDC Engine migration
  - Document Creation - Creating new blank documents (documentCreate)
  - Document Operations - Document-level operations like crop, resize, trim (documentOperations)
- Layer Operations:
  - Layer Operations Overview - Introduction to layer operations in V2
  - Image Layer Operations - Image and solid color layers
  - Text Layer Operations - Text layers with styling
  - Adjustment Layer Operations - Non-destructive adjustments
  - Smart Object Operations - Smart object layers
  - Advanced Layer Operations - Masks, groups, transforms, blend modes
- Other Operations:
  - Actions Migration - Photoshop actions and convenience APIs
  - Output Types Migration - JPEG, PNG, PSD, TIFF output format changes
  - Artboard Migration - Artboard operations
  - Manifest Migration - Manifest generation
  - Status Migration - Job status checking
Test your migration with non-production workloads
Update your production systems once testing is complete