• Update resolution levels in firefly-api.jsonlatest22Docs0fed5f92026-05-08 23:21

  Change detail

  4 changes across 1 operation

  AllBreakingWarningInfo

  • POST/v4/images/generate-async
    • breaking

      removed the enum value 2MP of the request property resolutionLevel

    • breaking

      removed the enum value auto of the request property resolutionLevel

    • info

      the resolutionLevel request property default value changed from auto to 2.4MP

    • info

      added the new 2.4MP enum value to the request property resolutionLevel

• Shorten reference blob URL field descriptionno API changesDocse443d0c2026-05-04 20:41
• Tighten Image5 descriptions and code markupno API changesDocs0bb02e22026-05-04 20:40
• Link video sizes to usage-notes aspect ratiosno API changesDocsa318be82026-04-28 18:43
• Update OpenAPI for precise upsampler GA on upscale47Docs93b50522026-04-24 23:07

  Change detail

  11 changes across 2 operations and 4 models

  AllBreakingWarningInfo

  • POST/v3/images/upscale
    • breaking

      the x-model-version request header's property undefined was restricted to a list of enum values

    • breaking

      the header request parameter x-model-version was restricted to a list of enum values

    • breaking

      for the header request parameter x-model-version, default value was changed from creative_upsampler_v1 to precise_upsampler_v1

    • info

      api operation id creativeUpsamplerV3Async removed and replaced with preciseUpsamplerV3Async

    • info

      added the new enum value precise_upsampler_v1 to the header request parameter x-model-version

  • GET/v3/status/{jobId}
    • breaking

      added PreciseUpsamplerResponse to the oneOf[subschema #1: JobSucceededPayload]/result response property oneOf list for the response status 200

    • info

      removed CreativeUpsamplerResponse from the oneOf[subschema #1: JobSucceededPayload]/result response property oneOf list for the response status 200

  View all changes (11)
• Enhance aspectRatio description in firefly-api.jsonno API changesDocsb8cf68b2026-04-24 20:09
• Document v4 Image5 resolutionLevel and aspect rules2Docsafa0a082026-04-24 20:05

  Change detail

  2 changes across 1 operation

  AllBreakingWarningInfo

  • POST/v4/images/generate-async
    • info

      added the new optional request property resolutionLevel

    • info

      added the new auto enum value to the request property aspectRatio

• Apply prompt reasoner alt text patch1Docsc2163ac2026-04-04 07:28

  Change detail

  1 change across 1 operation

  AllBreakingWarningInfo

  • POST/v4/images/generate-async
    • info

      added the new optional request property modelSpecificPayload/prompt_reasoner

• Align OpenAPI auth for S2S bearer and API keyno API changesDocs9f95e9a2026-03-31 21:41
• Merge branch 'main' into FFENT-9374-migrateUpscalePublicBeta33Docs1264cda2026-03-24 23:06

  Change detail

  6 changes across 3 operations

  AllBreakingWarningInfo

  • GET/v3/status/{jobId}
    • breaking

      added JobResult CreativeUpsamplerResponse to the oneOf[subschema #1: JobSucceededPayload]/result response property oneOf list for the response status 200

    • breaking

      the oneOf[subschema #1: JobSucceededPayload]/result response's property type changed from object to no type for status 200

    • breaking

      removed the required property oneOf[subschema #1: JobSucceededPayload]/result/outputs from the response with the 200 status

  • POST/v2/storage/image
    • info

      added the media type image/jxl to the request body

    • info

      added the media type image/tiff to the request body

  • POST/v3/images/upscale
    • info

      endpoint added

• Enhance firefly-api.json: Add new error response examples for validation and content policy checks, update schema references to ValidationErrorResponse and ContentPolicyErrorResponse, and introduce ne283471Docs89109af2026-03-24 21:48
• removed min refernceBlobs valueno API changesDocse6d60072026-03-24 21:33
• updated referenceBlobs from Archy's updateno API changesDocs774ae052026-03-24 21:26
• lint tags7Docs0ef44942026-03-24 21:07
• fix(api): add missing closing brace for AspectRatio in firefly-api.json schema201456399Docseb49ca22026-03-24 21:03
• Merge branch 'main' into FFENT-9371-im5MigrationGA288204436Docs9a669712026-03-24 21:01
• Update Upscale API name in Firefly API JSON schema to remove beta designation from the tag levelno API changesDocsdc8b6662026-03-23 23:31
• Update Upscale API name in Firefly API JSON schema to reflect beta statusno API changesDocseff100b2026-03-23 23:22
• Update Firefly API JSON schema to streamline Upscale API integration1Docsbc7ab452026-03-23 23:21
• docs(index, api): add Upscale API (beta) documentation and update Firefly API description36Docs5bb46992026-03-23 23:18
• Merge pull request #38 from AdobeDocs/FFENT-9014-OCMigrateGAno API changesDocs5ebd2102026-03-23 19:53
• docs(api): update Object Composite API references to Composite Operationsno API changesDocs62402362026-03-23 19:42
• docs(api): add Composite Operations section to Firefly API documentation3Docsd6feac22026-03-23 19:31
• docs(api): use <string> placeholders for uploadId and jobId examplesno API changesDocs43dff942026-03-23 18:56
• Description line editno API changesDocs5dedba12026-03-23 17:26
• FFENT-9469: Removed the x-request-id header definition from the Firefly API JSON schema in multiple locations to streamline the request structure.2Docs128222a2026-03-23 17:02
• added allowed storage domans to usage notes for OC, and included that link the JSON for source.url.no API changesDocs02bf8b92026-03-22 19:58
• Tushar's edits for "latest" architecture files71450Docs491872f2026-03-22 19:34
• lint API spec13Docs9f25f202026-03-18 22:21
• removed IM5 tag1179Docs48cf2a82026-03-18 21:59
• added IM5 endpoint (AI)6269Docs63138282026-03-18 21:56
• Updated side nav summary for both new endpointsno API changesDocs9f9fc432026-03-17 22:56
• Updated Firefly API documentation to replace the v4 object composite endpoint with a new v3 precise composite endpoint, including detailed request and response schemas. Added a new v3 adaptive composi61440Docs798f7942026-03-17 22:53
• fix: update documentation to clarify negative prompting limitations for Firefly Custom Models5265Docsaa73de52026-03-17 00:08
• uploadid line editsno API changesDocsdbdf1542026-03-16 17:06
• updated /cancel and /status with the new schemas from the OC beta spec61422Docs46881402026-03-16 17:01
• Rearrenged tags:18Docseb9bd0f2026-03-16 16:59
• moved manage job tag to bottom of listno API changesDocs09adc8b2026-03-15 04:58
• reordered tags and renamed Common Operations to Custom Model operations16Docs96eedae2026-03-15 04:57
• added OC endpoints (AI)1Docs93d8d262026-03-15 04:54
• added listed conditions to OC endpoint descriptionno API changesDocsedbd2002026-02-12 01:03
• edit review (AI)no API changesDocs52a80632026-02-11 02:45
• removed the contradictory OC prompt description saying it's optionalno API changesDocsf9edaa62026-02-11 02:35
• removed the requirement for mask param2Docs88046842026-02-11 02:33
• correct video generate header required (FFENT-5019)1Docs405d9c82026-01-10 04:15
• removed asyncronous process descriptions from endpoint path descriptionsno API changesDocs62e031e2026-01-06 23:22
• edit review (AI)no API changesDocs6078cdc2026-01-06 23:05
• edit review (AI script)no API changesDocs5c5a3fc2026-01-06 22:17
• added Common Operations tag8Docsa6d32f72026-01-06 22:01
• reordered endpointsDocsb1971892026-01-06 21:55

Revisions go back to the API's first capture.