data-slots=image, heading, text
Adobe Photoshop API - Firefly Services
Overview
Welcome to the Adobe Photoshop API, now integrated into Firefly Services. Our API follows REST-like principles, utilizing standard HTTP response codes, verbs, and authentication methods that return JSON-encoded responses. While the examples provided are in cURL, feel free to develop your application in any preferred language.
This guide will assist you in:
- Creating a project within the Adobe Developer Console
- Obtaining and authenticating your credentials
- Constructing personalized workflows by chaining API calls to various endpoints within the Firefly Services APIs
- Developing event-driven applications through Adobe I/O Events
What Photoshop API services are available?
Many useful Photoshop operations are available in the Photoshop API. Here are just a few:
- Remove background — Detect and isolate the main subject with AI and remove the background while preserving the subject for use in composites and cutouts.
- Smart Objects — Create and replace embedded Smart Objects in a PSD so new imagery fits the original layer bounds and keeps its aspect ratio.
- Product Crop — Smart-crop images by detecting the subject and framing it as the focal point (single-layer inputs; multilayer PSDs are not supported).
- ActionJSON — Apply Photoshop Actions from an ATN file programmatically and adjust the action payload for more flexible, dynamic edits than a static action alone.
Explore all the available Photoshop API services in the Photoshop API guides. Or review the endpoints in the Photoshop API reference.
What is Photoshop v2 beta?
data-slots=text
data-backgroundcolor=blue
The Photoshop v2 beta API is a unified next-generation surface for Photoshop and Lightroom-style workflows in Firefly Services: one architecture, consistent request and response patterns, and flexible output destinations. Use it when you want combined operations in fewer round trips, clearer status handling, and migration paths from the legacy v1 Photoshop and Lightroom APIs.
What improvements does Photoshop v2 beta offer?
Photoshop v2 beta allows you to:
- Run Photoshop operations — Create composites, edit documents and layers, execute actions, generate manifests, and create artboards through versioned
/v2endpoints. - Check asynchronous jobs — Poll job status with a dedicated job-status model aligned to the v2 pipeline.
- Integrate storage flexibly — Use embedded, hosted, and external storage patterns with clear destination configuration.
- Regenerate storage URLs when needed — Use storage-related endpoints where applicable for your deployment.
What new features does Photoshop v2 beta offer?
- Unified API — Photoshop-oriented image processing plus job lifecycle and storage helpers documented under a single OpenAPI specification.
- Clear versioning —
v2paths and beta reference documentation kept separate from the shipping Photoshop API reference for easier comparison and migration. - Guides for migrating from v1 — Topic-based migration guides for edit, document, layer, actions, output, artboard, manifest, and status flows.
How can I use the Photoshop v2 beta API?
Explore the Photoshop v2 migration guides to learn how to change existing implementations to use the improved v2 API.
- Photoshop v2 beta guides — Migration overviews, v1-to-v2 topics, and getting started topics scoped to the v2 beta.
- Photoshop v2 beta API reference — Full endpoint reference for the
photoshopv2-api.jsonspecification.
Discover
data-slots=heading, link, text
data-slots=link, text
data-slots=link, text
data-slots=link, text
data-slots=link, text