Create Composite — Complete V1 Migration Reference

This page is the authoritative single-page reference for migrating from all four V1 Photoshop API composite-family endpoints to /v2/create-composite. It consolidates field-level comparisons for document creation, document operations, all layer types, and output formats.

For general concepts and context, see Layer Operations Overview. For individual topic deep dives, use the specific guides listed in that overview.

1. V1 endpoint coverage

All four V1 endpoints (and the informal smartObjectV2 variant) map to the single V2 endpoint:

2. Request envelope

Input

Output

V1 vs V2 envelope example

V1 (documentOperations):

{
  "inputs": [{"href": "<SIGNED_GET_URL>", "storage": "external"}],
  "options": {
    "layers": [
      {
        "type": "textLayer",
        "name": "Title",
        "add": {"insertTop": true},
        "text": {"content": "Hello"}
      }
    ]
  },
  "outputs": [{"href": "<SIGNED_POST_URL>", "storage": "external", "type": "image/vnd.adobe.photoshop"}]
}

V2 (/v2/create-composite):

{
  "image": {"source": {"url": "<SIGNED_GET_URL>"}},
  "edits": {
    "layers": [
      {
        "type": "text_layer",
        "name": "Title",
        "operation": {"type": "add", "placement": {"type": "top"}},
        "text": {"content": "Hello"}
      }
    ]
  },
  "outputs": [
    {"destination": {"url": "<SIGNED_POST_URL>"}, "mediaType": "image/vnd.adobe.photoshop"}
  ]
}

Layer processing order

data-variant=warning

data-slots=text

3. Document creation parameters

documentCreate options.document.* → V2 image.* (top-level):

data-variant=warning

data-slots=text

V1 (string):

{ "fill": "white" }

V2 (object form for custom RGB):

{ "fill": {"solidColor": {"rgb": {"red": 255, "green": 255, "blue": 255}}} }

4. Document-level operations

Resize (edits.document.imageSize)

Trim (edits.document.trim)

data-variant=warning

data-slots=text

5. Layer operation model

Operation specification

V1: Separate sibling objects on each layer entry:

{
  "type": "textLayer",
  "name": "My Layer",
  "add": {"insertTop": true},
  "text": {"content": "Hello"}
}

V2: Unified operation object:

{
  "type": "text_layer",
  "name": "My Layer",
  "operation": {"type": "add", "placement": {"type": "top"}},
  "text": {"content": "Hello"}
}

Placement type mapping

data-variant=info

data-slots=text

6. Common layer properties

Lock / protection

Visibility

Blend options

Blend mode enum values (all 29 — unchanged between V1 and V2): normal, dissolve, darken, multiply, color_burn, linear_burn, darker_color, lighten, screen, color_dodge, linear_dodge, lighter_color, overlay, soft_light, hard_light, vivid_light, linear_light, pin_light, hard_mix, difference, exclusion, subtract, divide, hue, saturation, color, luminosity, pass_through

Pixel layer bounds / transform

Mask fields

fillToCanvas (missing feature)

data-variant=warning

data-slots=text

7. Per-layer-type reference

7a. Adjustment layers (adjustmentLayer → adjustment_layer)

Type rename: "adjustmentLayer" → "adjustment_layer"

data-variant=warning

data-slots=text

V1:

{"adjustments": {"brightnessContrast": {"brightness": 25}}}

V2:

{"adjustments": {"type": "brightness_contrast", "brightnessContrast": {"brightness": 25}}}

Adjustment type name mapping:

Field changes within adjustment payloads:

7b. Background layers

data-variant=warning

data-slots=text

7c. Solid color layers (fillLayer → solid_color_layer)

Type rename: "fillLayer" → "solid_color_layer"

The RGB field structure inside solidColor is unchanged between V1 and V2.

7d. Pixel layers (layer → layer)

Type name: Unchanged ("layer")

Key changes for pixel layers:

• Bounds: V1 bounds: {left, top, width, height} → V2 transform: {offset: {horizontal, vertical}, dimension: {width, height}}
• Mask: mask.input → mask.source.url; mask.linked → mask.isLinked; mask.enabled → mask.isEnabled
• Clipping: mask.clip: true → isClipped: true (top-level)
• fillToCanvas: Not supported in V2

7e. Group layers (layerSection → group_layer)

Type rename: "layerSection" → "group_layer"

Creating a new document with a group layer is not yet supported (upcoming feature). Editing an existing document to add a layer inside a group layer is supported: use operation.placement.type: "into" with referenceLayer pointing to the group (e.g. "referenceLayer": { "name": "Group 1" }). Editing existing group layers (name, visibility, protection, etc.) is also supported. V1 nested children under the layer's children array.

7f. Smart object layers (smartObject → smart_object_layer)

Type rename: "smartObject" → "smart_object_layer"

data-variant=info

data-slots=text

7g. Text layers (textLayer → text_layer)

Type rename: "textLayer" → "text_layer"

data-variant=warning

data-slots=text

Example: To style the first 5 characters ("Hello" in "Hello World"):

V1: {"from": 0, "to": 5, "fontName": "Arial-BoldMT"} — to: 5 means length 5

V2: {"apply": {"from": 0, "to": 4}, "characterStyle": {"font": {"postScriptName": "Arial-BoldMT"}}} — to: 4 is the index of the last character

Character style field mapping:

Paragraph style field mapping:

Text frame:

Font options:

8. Output format reference

JPEG quality

PNG compression

TIFF

V1 accepted TIFF output via renditionCreate. TIFF is supported in V2 as an output format.

Storage / destination mapping

New output features in V2

Missing V2 features summary

See also

• Layer Operations Overview — General V2 layer concepts and processing order
• Text Layers — Detailed text layer migration with examples
• Adjustment Layers — All supported adjustment types
• Smart Objects — Smart object layer migration
• Advanced Operations — Masks, groups, blend modes, transforms
• Document Creation — Creating new blank documents
• Document Operations — Crop, resize, trim
• Output Types — JPEG, PNG, TIFF output format details