Adobe Photoshop · Capability

Adobe Photoshop API

A cloud-based REST API that provides programmatic access to Photoshop's image editing capabilities without requiring a local installation. Part of Adobe Firefly Services, the API supports PSD document operations including layer editing, Smart Object replacement, text layer editing, rendition creation, and artboard management. It also provides AI-powered features such as background removal, mask creation, product crop, and depth blur. All operations are asynchronous, returning a polling URL to check job status.

Run with Naftiko AdobePhotoshopAPI

What You Can Do

POST
Removebackgroundv2 — Adobe Photoshop Remove Background from an Image
/v2/remove-background
POST
Fillmaskedareas — Adobe Photoshop Fill Masked Areas with Generative AI
/v1/fill-masked-areas
POST
Getdocumentmanifest — Adobe Photoshop Get PSD Document Manifest
/pie/psdService/documentManifest
POST
Modifydocument — Adobe Photoshop Edit a PSD Document
/pie/psdService/documentOperations
POST
Createdocument — Adobe Photoshop Create a New PSD Document
/pie/psdService/documentCreate
POST
Createrendition — Adobe Photoshop Create Image Renditions from a PSD
/pie/psdService/renditionCreate
POST
Replacesmartobject — Adobe Photoshop Replace Smart Object Content
/pie/psdService/smartObject
POST
Edittextlayer — Adobe Photoshop Edit Text Layers in a PSD
/pie/psdService/text
POST
Playphotoshopactions — Adobe Photoshop Execute Photoshop Action Files
/pie/psdService/photoshopActions
POST
Playactionjson — Adobe Photoshop Execute Photoshop Actions via JSON Descriptors
/pie/psdService/actionJSON
POST
Createwithactionjson — Adobe Photoshop Create Documents Using Action JSON Descriptors
/pie/psdService/actionJsonCreate
POST
Productcrop — Adobe Photoshop Smart Crop to Product Subject
/pie/psdService/productCrop
POST
Depthblur — Adobe Photoshop Apply Depth Blur Effect
/pie/psdService/depthBlur
POST
Createartboard — Adobe Photoshop Create Artboards from PSD Inputs
/pie/psdService/artboardCreate
GET
Getpsdjobstatus — Adobe Photoshop Get PSD Service Job Status
/pie/psdService/status/{jobId}
GET
Getsenseijobstatus — Adobe Photoshop Get Sensei Service Job Status
/sensei/status/{jobId}
GET
Healthcheck — Adobe Photoshop Service Health Check
/pie/psdService/hello

MCP Tools

removebackgroundv2

Adobe Photoshop Remove Background from an Image

fillmaskedareas

Adobe Photoshop Fill Masked Areas with Generative AI

getdocumentmanifest

Adobe Photoshop Get PSD Document Manifest

modifydocument

Adobe Photoshop Edit a PSD Document

createdocument

Adobe Photoshop Create a New PSD Document

createrendition

Adobe Photoshop Create Image Renditions from a PSD

replacesmartobject

Adobe Photoshop Replace Smart Object Content

edittextlayer

Adobe Photoshop Edit Text Layers in a PSD

playphotoshopactions

Adobe Photoshop Execute Photoshop Action Files

playactionjson

Adobe Photoshop Execute Photoshop Actions via JSON Descriptors

createwithactionjson

Adobe Photoshop Create Documents Using Action JSON Descriptors

productcrop

Adobe Photoshop Smart Crop to Product Subject

depthblur

Adobe Photoshop Apply Depth Blur Effect

createartboard

Adobe Photoshop Create Artboards from PSD Inputs

getpsdjobstatus

Adobe Photoshop Get PSD Service Job Status

read-only idempotent
getsenseijobstatus

Adobe Photoshop Get Sensei Service Job Status

read-only idempotent
healthcheck

Adobe Photoshop Service Health Check

read-only idempotent

Capability Spec

adobe-photoshop-capability.yaml Raw ↑ 
naftiko: 1.0.0-alpha2
info:
  label: Adobe Photoshop API
  description: A cloud-based REST API that provides programmatic access to Photoshop's image editing capabilities without
    requiring a local installation. Part of Adobe Firefly Services, the API supports PSD document operations including layer
    editing, Smart Object replacement, text layer editing, rendition creation, and artboard management. It also provides AI-powered
    features such as background removal, mask creation, product crop, and depth blur. All operations are asynchronous, returning
    a polling URL to check job status.
  tags:
  - Adobe
  - Photoshop
  - API
  created: '2026-05-06'
  modified: '2026-05-06'
capability:
  consumes:
  - type: http
    namespace: adobe-photoshop
    baseUri: https://image.adobe.io
    description: Adobe Photoshop API HTTP API.
    authentication:
      type: bearer
      token: '{{ADOBE_PHOTOSHOP_TOKEN}}'
    resources:
    - name: v2-remove-background
      path: /v2/remove-background
      operations:
      - name: removebackgroundv2
        method: POST
        description: Adobe Photoshop Remove Background from an Image
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: v1-fill-masked-areas
      path: /v1/fill-masked-areas
      operations:
      - name: fillmaskedareas
        method: POST
        description: Adobe Photoshop Fill Masked Areas with Generative AI
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: pie-psdservice-documentmanifest
      path: /pie/psdService/documentManifest
      operations:
      - name: getdocumentmanifest
        method: POST
        description: Adobe Photoshop Get PSD Document Manifest
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: pie-psdservice-documentoperations
      path: /pie/psdService/documentOperations
      operations:
      - name: modifydocument
        method: POST
        description: Adobe Photoshop Edit a PSD Document
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: pie-psdservice-documentcreate
      path: /pie/psdService/documentCreate
      operations:
      - name: createdocument
        method: POST
        description: Adobe Photoshop Create a New PSD Document
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: pie-psdservice-renditioncreate
      path: /pie/psdService/renditionCreate
      operations:
      - name: createrendition
        method: POST
        description: Adobe Photoshop Create Image Renditions from a PSD
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: pie-psdservice-smartobject
      path: /pie/psdService/smartObject
      operations:
      - name: replacesmartobject
        method: POST
        description: Adobe Photoshop Replace Smart Object Content
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: pie-psdservice-text
      path: /pie/psdService/text
      operations:
      - name: edittextlayer
        method: POST
        description: Adobe Photoshop Edit Text Layers in a PSD
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: pie-psdservice-photoshopactions
      path: /pie/psdService/photoshopActions
      operations:
      - name: playphotoshopactions
        method: POST
        description: Adobe Photoshop Execute Photoshop Action Files
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: pie-psdservice-actionjson
      path: /pie/psdService/actionJSON
      operations:
      - name: playactionjson
        method: POST
        description: Adobe Photoshop Execute Photoshop Actions via JSON Descriptors
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: pie-psdservice-actionjsoncreate
      path: /pie/psdService/actionJsonCreate
      operations:
      - name: createwithactionjson
        method: POST
        description: Adobe Photoshop Create Documents Using Action JSON Descriptors
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: pie-psdservice-productcrop
      path: /pie/psdService/productCrop
      operations:
      - name: productcrop
        method: POST
        description: Adobe Photoshop Smart Crop to Product Subject
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: pie-psdservice-depthblur
      path: /pie/psdService/depthBlur
      operations:
      - name: depthblur
        method: POST
        description: Adobe Photoshop Apply Depth Blur Effect
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: pie-psdservice-artboardcreate
      path: /pie/psdService/artboardCreate
      operations:
      - name: createartboard
        method: POST
        description: Adobe Photoshop Create Artboards from PSD Inputs
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: pie-psdservice-status-jobid
      path: /pie/psdService/status/{jobId}
      operations:
      - name: getpsdjobstatus
        method: GET
        description: Adobe Photoshop Get PSD Service Job Status
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: sensei-status-jobid
      path: /sensei/status/{jobId}
      operations:
      - name: getsenseijobstatus
        method: GET
        description: Adobe Photoshop Get Sensei Service Job Status
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: pie-psdservice-hello
      path: /pie/psdService/hello
      operations:
      - name: healthcheck
        method: GET
        description: Adobe Photoshop Service Health Check
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
  exposes:
  - type: rest
    port: 8080
    namespace: adobe-photoshop-rest
    description: REST adapter for Adobe Photoshop API.
    resources:
    - path: /v2/remove-background
      name: removebackgroundv2
      operations:
      - method: POST
        name: removebackgroundv2
        description: Adobe Photoshop Remove Background from an Image
        call: adobe-photoshop.removebackgroundv2
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/fill-masked-areas
      name: fillmaskedareas
      operations:
      - method: POST
        name: fillmaskedareas
        description: Adobe Photoshop Fill Masked Areas with Generative AI
        call: adobe-photoshop.fillmaskedareas
        outputParameters:
        - type: object
          mapping: $.
    - path: /pie/psdService/documentManifest
      name: getdocumentmanifest
      operations:
      - method: POST
        name: getdocumentmanifest
        description: Adobe Photoshop Get PSD Document Manifest
        call: adobe-photoshop.getdocumentmanifest
        outputParameters:
        - type: object
          mapping: $.
    - path: /pie/psdService/documentOperations
      name: modifydocument
      operations:
      - method: POST
        name: modifydocument
        description: Adobe Photoshop Edit a PSD Document
        call: adobe-photoshop.modifydocument
        outputParameters:
        - type: object
          mapping: $.
    - path: /pie/psdService/documentCreate
      name: createdocument
      operations:
      - method: POST
        name: createdocument
        description: Adobe Photoshop Create a New PSD Document
        call: adobe-photoshop.createdocument
        outputParameters:
        - type: object
          mapping: $.
    - path: /pie/psdService/renditionCreate
      name: createrendition
      operations:
      - method: POST
        name: createrendition
        description: Adobe Photoshop Create Image Renditions from a PSD
        call: adobe-photoshop.createrendition
        outputParameters:
        - type: object
          mapping: $.
    - path: /pie/psdService/smartObject
      name: replacesmartobject
      operations:
      - method: POST
        name: replacesmartobject
        description: Adobe Photoshop Replace Smart Object Content
        call: adobe-photoshop.replacesmartobject
        outputParameters:
        - type: object
          mapping: $.
    - path: /pie/psdService/text
      name: edittextlayer
      operations:
      - method: POST
        name: edittextlayer
        description: Adobe Photoshop Edit Text Layers in a PSD
        call: adobe-photoshop.edittextlayer
        outputParameters:
        - type: object
          mapping: $.
    - path: /pie/psdService/photoshopActions
      name: playphotoshopactions
      operations:
      - method: POST
        name: playphotoshopactions
        description: Adobe Photoshop Execute Photoshop Action Files
        call: adobe-photoshop.playphotoshopactions
        outputParameters:
        - type: object
          mapping: $.
    - path: /pie/psdService/actionJSON
      name: playactionjson
      operations:
      - method: POST
        name: playactionjson
        description: Adobe Photoshop Execute Photoshop Actions via JSON Descriptors
        call: adobe-photoshop.playactionjson
        outputParameters:
        - type: object
          mapping: $.
    - path: /pie/psdService/actionJsonCreate
      name: createwithactionjson
      operations:
      - method: POST
        name: createwithactionjson
        description: Adobe Photoshop Create Documents Using Action JSON Descriptors
        call: adobe-photoshop.createwithactionjson
        outputParameters:
        - type: object
          mapping: $.
    - path: /pie/psdService/productCrop
      name: productcrop
      operations:
      - method: POST
        name: productcrop
        description: Adobe Photoshop Smart Crop to Product Subject
        call: adobe-photoshop.productcrop
        outputParameters:
        - type: object
          mapping: $.
    - path: /pie/psdService/depthBlur
      name: depthblur
      operations:
      - method: POST
        name: depthblur
        description: Adobe Photoshop Apply Depth Blur Effect
        call: adobe-photoshop.depthblur
        outputParameters:
        - type: object
          mapping: $.
    - path: /pie/psdService/artboardCreate
      name: createartboard
      operations:
      - method: POST
        name: createartboard
        description: Adobe Photoshop Create Artboards from PSD Inputs
        call: adobe-photoshop.createartboard
        outputParameters:
        - type: object
          mapping: $.
    - path: /pie/psdService/status/{jobId}
      name: getpsdjobstatus
      operations:
      - method: GET
        name: getpsdjobstatus
        description: Adobe Photoshop Get PSD Service Job Status
        call: adobe-photoshop.getpsdjobstatus
        outputParameters:
        - type: object
          mapping: $.
    - path: /sensei/status/{jobId}
      name: getsenseijobstatus
      operations:
      - method: GET
        name: getsenseijobstatus
        description: Adobe Photoshop Get Sensei Service Job Status
        call: adobe-photoshop.getsenseijobstatus
        outputParameters:
        - type: object
          mapping: $.
    - path: /pie/psdService/hello
      name: healthcheck
      operations:
      - method: GET
        name: healthcheck
        description: Adobe Photoshop Service Health Check
        call: adobe-photoshop.healthcheck
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    port: 9090
    namespace: adobe-photoshop-mcp
    transport: http
    description: MCP adapter for Adobe Photoshop API for AI agent use.
    tools:
    - name: removebackgroundv2
      description: Adobe Photoshop Remove Background from an Image
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: adobe-photoshop.removebackgroundv2
      outputParameters:
      - type: object
        mapping: $.
    - name: fillmaskedareas
      description: Adobe Photoshop Fill Masked Areas with Generative AI
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: adobe-photoshop.fillmaskedareas
      outputParameters:
      - type: object
        mapping: $.
    - name: getdocumentmanifest
      description: Adobe Photoshop Get PSD Document Manifest
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: adobe-photoshop.getdocumentmanifest
      outputParameters:
      - type: object
        mapping: $.
    - name: modifydocument
      description: Adobe Photoshop Edit a PSD Document
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: adobe-photoshop.modifydocument
      outputParameters:
      - type: object
        mapping: $.
    - name: createdocument
      description: Adobe Photoshop Create a New PSD Document
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: adobe-photoshop.createdocument
      outputParameters:
      - type: object
        mapping: $.
    - name: createrendition
      description: Adobe Photoshop Create Image Renditions from a PSD
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: adobe-photoshop.createrendition
      outputParameters:
      - type: object
        mapping: $.
    - name: replacesmartobject
      description: Adobe Photoshop Replace Smart Object Content
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: adobe-photoshop.replacesmartobject
      outputParameters:
      - type: object
        mapping: $.
    - name: edittextlayer
      description: Adobe Photoshop Edit Text Layers in a PSD
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: adobe-photoshop.edittextlayer
      outputParameters:
      - type: object
        mapping: $.
    - name: playphotoshopactions
      description: Adobe Photoshop Execute Photoshop Action Files
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: adobe-photoshop.playphotoshopactions
      outputParameters:
      - type: object
        mapping: $.
    - name: playactionjson
      description: Adobe Photoshop Execute Photoshop Actions via JSON Descriptors
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: adobe-photoshop.playactionjson
      outputParameters:
      - type: object
        mapping: $.
    - name: createwithactionjson
      description: Adobe Photoshop Create Documents Using Action JSON Descriptors
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: adobe-photoshop.createwithactionjson
      outputParameters:
      - type: object
        mapping: $.
    - name: productcrop
      description: Adobe Photoshop Smart Crop to Product Subject
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: adobe-photoshop.productcrop
      outputParameters:
      - type: object
        mapping: $.
    - name: depthblur
      description: Adobe Photoshop Apply Depth Blur Effect
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: adobe-photoshop.depthblur
      outputParameters:
      - type: object
        mapping: $.
    - name: createartboard
      description: Adobe Photoshop Create Artboards from PSD Inputs
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: adobe-photoshop.createartboard
      outputParameters:
      - type: object
        mapping: $.
    - name: getpsdjobstatus
      description: Adobe Photoshop Get PSD Service Job Status
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: adobe-photoshop.getpsdjobstatus
      outputParameters:
      - type: object
        mapping: $.
    - name: getsenseijobstatus
      description: Adobe Photoshop Get Sensei Service Job Status
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: adobe-photoshop.getsenseijobstatus
      outputParameters:
      - type: object
        mapping: $.
    - name: healthcheck
      description: Adobe Photoshop Service Health Check
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: adobe-photoshop.healthcheck
      outputParameters:
      - type: object
        mapping: $.
binds:
- namespace: env
  keys:
    ADOBE_PHOTOSHOP_TOKEN: ADOBE_PHOTOSHOP_TOKEN