Photoshop API guides

Use this page to choose the right guide collection: Photoshop API v2 (recommended for new work), Photoshop API v1 (legacy), or Migration topics that map v1 workflows to v2.

Photoshop API v2 guides

The v2 API offers a unified architecture, combined operations, and flexible storage.

• About Photoshop v2 API — Orientation for v2 guides and how they fit with migration topics.
• Photoshop API v2 workflow guides — Step-by-step workflows such as Execute Actions, Smart Objects, and benchmarking.

For endpoint-level detail, see the Photoshop API v2 reference.

Photoshop API v1 guides

Deprecated. Photoshop API v1 is scheduled for end of life; use v2 for new integrations. The v1 guides remain available for existing implementations and reference.

• Photoshop API v1 guides overview — Prerequisites, sample PSD setup, authentication, code samples, and links into the v1 topic guides.

For the OpenAPI reference for v1 endpoints, see the Photoshop API v1 reference.

Migration (v1 to v2)

If you use legacy v1 Photoshop or Lightroom APIs, use these resources to plan and execute migration.

• Migrating to v2 overview — Breaking changes, a migration path, and a table mapping v1 endpoints to v2 guides.
• Key improvements and architecture with v2 — Why migrate: combined operations, storage options, published action files, and architecture.

From the migration overview you can open topic guides for edit operations, documents, layers, actions, artboards, manifest, status, convenience APIs, and more.