Guides

Guides help you get the most out of the Photoshop v2 API—from migrating from v1 to using specific endpoints and workflows.

Overview

Use this section to find step-by-step guidance for the Photoshop v2 API. Whether you're new to the API or moving from the legacy v1 Photoshop or Lightroom APIs, start with the links below and then dive into the detailed guides for your use case.

Migrating from v1?

If you're already using the legacy Photoshop or Lightroom APIs (v1), the v2 API offers a unified architecture, combined operations in a single call, and more flexible storage—with a clear path to migrate.

Start here:

• Migration to v2 overview — What's changing, breaking changes, and a step-by-step migration path with a reference table that maps each v1 endpoint to its v2 equivalent and the right guide.
• Key improvements and architecture with v2 — Why migrate: combined operations, flexible storage options, published action files, and other architectural benefits.

From the migration overview you can jump to detailed guides for your endpoints: edit operations, format conversion, document creation, layer operations, actions, artboards, manifest, status, and convenience APIs.