Scenario Versions

Get scenario version blueprint

Changed on

Returns the blueprint and metadata for a specific version of the scenario.

get/api/v3/scenarios/{scenarioId}/versions/{version}

Request

  • Base URL: https://fusion.adobe.io
  • URL: https://fusion.adobe.io/api/v3/scenarios/{scenarioId}/versions/{version}
  • Auth: HTTP bearer and API key in header x-organization-id and API key in header x-api-key and API key in header x-gw-region

Path parameters

scenarioIdnumber required
Example:123

Scenario ID

versionnumber required
Example:3

Scenario version number

Response

Scenario version blueprint and metadata

versionnumber required

Version number.

scenarioIdnumber required

ID of the scenario this version belongs to.

createdAtstring date-time required

ISO 8601 timestamp when this version was created.

commentstring

Optional comment describing this version.

blueprintobject required

Full automation blueprint for this scenario version.

Example response

{
  "version": 3,
  "scenarioId": 123,
  "createdAt": "2026-03-05T15:20:00.000Z",
  "comment": "Fixed connection timeout issue.",
  "blueprint": {
    "flow": [
      {
        "id": 1,
        "mapper": {
          "n": "1",
          "style": {
            "imageReference": {}
          },
          "locale": "en-US",
          "prompt": "ocean and pineapple cocktail",
          "extension": "default",
          "structure": {
            "imageReference": {}
          }
        },
        "module": "adobe-firefly:generateAnImage2",
        "version": 1,
        "metadata": {
          "expect": [
            {
              "name": "prompt",
              "type": "text",
              "label": "Prompt",
              "required": true
            },
            {
              "name": "modelVersion",
              "type": "select",
              "label": "Model version",
              "validate": {
                "enum": [
                  "image3",
                  "image3_custom",
                  "image4_standard",
                  "image4_ultra",
                  "image4_custom"
                ]
              }
            },
            {
              "name": "n",
              "type": "number",
              "label": "Number of variations"
            },
            {
              "name": "extension",
              "type": "select",
              "label": "Generated image format",
              "required": true,
              "validate": {
                "enum": [
                  "jpeg",
                  "png",
                  "webp",
                  "default"
                ]
              }
            },
            {
              "name": "negativePrompt",
              "type": "text",
              "label": "Negative prompt"
            },
            {
              "name": "contentClass",
              "type": "select",
              "label": "Content class",
              "validate": {
                "enum": [
                  "photo",
                  "art"
                ]
              }
            },
            {
              "name": "seeds",
              "type": "array",
              "label": "Seeds"
            },
            {
              "name": "size",
              "type": "select",
              "label": "Size",
              "validate": {
                "enum": [
                  "2048,2048",
                  "1024,1024",
                  "2304,1792",
                  "1792,2304",
                  "2688,1536",
                  "1344,768",
                  "1152,896",
                  "896,1152"
                ]
              }
            },
            {
              "name": "visualIntensity",
              "type": "number",
              "label": "Visual intensity"
            },
            {
              "name": "locale",
              "type": "text",
              "label": "Locale"
            },
            {
              "name": "tileable",
              "type": "boolean",
              "label": "Tileable"
            },
            {
              "name": "structure",
              "spec": [
                {
                  "name": "imageReference",
                  "spec": [
                    {
                      "name": "source",
                      "type": "select",
                      "label": "Source",
                      "validate": {
                        "enum": [
                          "file",
                          "presignedUrl"
                        ]
                      }
                    },
                    {
                      "name": "strength",
                      "type": "number",
                      "label": "Strength"
                    }
                  ],
                  "type": "collection",
                  "label": "Image reference"
                }
              ],
              "type": "collection",
              "label": "Structure"
            },
            {
              "name": "style",
              "spec": [
                {
                  "name": "imageReference",
                  "spec": [
                    {
                      "name": "source",
                      "type": "select",
                      "label": "Source",
                      "validate": {
                        "enum": [
                          "file",
                          "presignedUrl"
                        ]
                      }
                    },
                    {
                      "name": "strength",
                      "type": "number",
                      "label": "Strength"
                    },
                    {
                      "name": "presets",
                      "type": "array",
                      "label": "Presets"
                    }
                  ],
                  "type": "collection",
                  "label": "Image reference"
                }
              ],
              "type": "collection",
              "label": "Style"
            }
          ],
          "restore": {
            "size": {
              "mode": "chose",
              "label": ""
            },
            "seeds": {
              "mode": "chose",
              "items": []
            },
            "style": {
              "nested": {
                "imageReference": {
                  "nested": {
                    "source": {
                      "mode": "chose",
                      "label": ""
                    },
                    "presets": {
                      "mode": "chose",
                      "items": []
                    }
                  }
                }
              }
            },
            "tileable": {
              "mode": "chose"
            },
            "extension": {
              "mode": "chose",
              "label": "Default"
            },
            "structure": {
              "nested": {
                "imageReference": {
                  "nested": {
                    "source": {
                      "mode": "chose",
                      "label": ""
                    }
                  }
                }
              }
            },
            "connection": {
              "label": "My Adobe Firefly Connection connection"
            },
            "contentClass": {
              "mode": "chose",
              "label": ""
            },
            "modelVersion": {
              "mode": "chose",
              "label": ""
            }
          },
          "designer": {
            "x": 0,
            "y": 0
          },
          "parameters": [
            {
              "name": "connection",
              "type": "account",
              "label": "Connection",
              "required": true
            }
          ]
        },
        "parameters": {
          "connection": 23252
        }
      }
    ],
    "name": "Integration Adobe Firefly",
    "metadata": {
      "instant": false,
      "version": 1,
      "designer": {
        "orphans": []
      },
      "scenario": {
        "dlq": false,
        "dataloss": false,
        "maxErrors": 3,
        "autoCommit": true,
        "roundtrips": 1,
        "sequential": false,
        "confidential": false,
        "autoCommitTriggerLast": true
      }
    }
  }
}

Changes