{
  "components": {
    "schemas": {
      "BracketCreatedOut": {
        "additionalProperties": false,
        "properties": {
          "bracket_id": {
            "type": "string"
          },
          "image_id": {
            "readOnly": true
          },
          "is_excluded": {
            "readOnly": true,
            "type": "boolean"
          },
          "is_uploaded": {
            "type": "boolean"
          },
          "metadata": {
            "additionalProperties": {},
            "description": "Metadata for the bracket.",
            "type": "object"
          },
          "name": {
            "type": "string"
          },
          "order_id": {
            "readOnly": true
          },
          "upload_url": {
            "readOnly": true
          }
        },
        "type": "object"
      },
      "BracketIn": {
        "properties": {
          "metadata": {
            "additionalProperties": {},
            "description": "Metadata for the bracket.",
            "type": "object"
          },
          "name": {
            "pattern": "^[^/]+$",
            "type": "string"
          },
          "order_id": {
            "minLength": 1,
            "type": "string"
          }
        },
        "required": [
          "name",
          "order_id"
        ],
        "type": "object"
      },
      "BracketOut": {
        "additionalProperties": false,
        "properties": {
          "bracket_id": {
            "type": "string"
          },
          "image_id": {
            "readOnly": true
          },
          "is_excluded": {
            "readOnly": true,
            "type": "boolean"
          },
          "is_uploaded": {
            "type": "boolean"
          },
          "metadata": {
            "additionalProperties": {},
            "description": "Metadata for the bracket.",
            "type": "object"
          },
          "name": {
            "type": "string"
          },
          "order_id": {
            "readOnly": true
          }
        },
        "type": "object"
      },
      "FinetuneOptions": {
        "additionalProperties": false,
        "properties": {},
        "type": "object"
      },
      "HTTPError": {
        "properties": {
          "detail": {
            "type": "object"
          },
          "message": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "ImageCreatedOut": {
        "additionalProperties": false,
        "properties": {
          "ai_version": {
            "description": "The version of the AI model to use for enhancing the image. Versions ending in an .x will use the latest minor version as soon as it's published.",
            "type": "string"
          },
          "cloud_type": {
            "description": "The type of clouds in the new sky to replace the original sky with. Options include: CLEAR, LOW_CLOUD, HIGH_CLOUD",
            "enum": [
              "CLEAR",
              "LOW_CLOUD",
              "HIGH_CLOUD",
              null
            ],
            "nullable": true,
            "type": "string"
          },
          "date_added": {
            "description": "The date the image was registered with Autoenhance.",
            "type": "integer"
          },
          "downloaded": {
            "description": "Whether the image has already been downloaded and paid for.",
            "type": "boolean"
          },
          "enhance": {
            "default": true,
            "description": "Whether to enhance the image.",
            "type": "boolean"
          },
          "finetune_settings": {
            "anyOf": [
              {
                "nullable": true,
                "type": "object"
              },
              {
                "$ref": "#/components/schemas/FinetuneOptions"
              }
            ]
          },
          "image_id": {
            "format": "uuid",
            "type": "string"
          },
          "image_name": {
            "type": "string"
          },
          "lens_correction": {
            "default": true,
            "description": "Correct any lens distortion in the image.",
            "type": "boolean"
          },
          "metadata": {
            "additionalProperties": {},
            "description": "Metadata for the image.",
            "type": "object"
          },
          "order_id": {
            "readOnly": true
          },
          "parent_image_id": {
            "description": "The ID of the parent image if this is a sub-image created for premium restaging. Null for original images.",
            "nullable": true,
            "type": "string"
          },
          "perspective_correction": {
            "description": "Whether perspective correction is enabled for the image.",
            "nullable": true,
            "type": "boolean"
          },
          "perspective_correction_mode": {
            "description": "The perspective correction mode used for the image. 'OFF' means disabled, 'DEFAULT_ENABLED' uses AI defaults, 'PRESERVE_CONTENT' prioritizes keeping content, 'PRIORITIZE_PERSPECTIVE' prioritizes straight lines.",
            "enum": [
              "OFF",
              "DEFAULT_ENABLED",
              "PRESERVE_CONTENT",
              "PRIORITIZE_PERSPECTIVE",
              null
            ],
            "nullable": true,
            "type": "string"
          },
          "preset_id": {
            "description": "The ID of the preset that was applied to the image.",
            "readOnly": true
          },
          "preset_version": {
            "description": "Preset version applied when the image was last processed with a preset.",
            "nullable": true,
            "readOnly": true
          },
          "privacy": {
            "description": "Whether to blur any faces or license plates in the image.",
            "nullable": true,
            "type": "boolean"
          },
          "rating": {
            "description": "A rating between 0 and 5 on how good the image enhancement is. Higher is better.",
            "maximum": 5,
            "minimum": 0,
            "type": "integer"
          },
          "restage": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Restage"
              },
              {
                "nullable": true,
                "type": "object"
              }
            ],
            "description": "Restage options for in-painting or modifying scene elements. Allows correcting details like lighting a fireplace, removing fingerprints from a TV screen, or removing unwanted items like tripods."
          },
          "scene": {
            "description": "The detected scene of the image, for example garden, patio or kitchen.",
            "type": "string"
          },
          "sky_replacement": {
            "description": "Whether the sky replacement feature was enabled for the image.",
            "type": "boolean"
          },
          "status": {
            "description": "The processing status of the image.",
            "readOnly": true
          },
          "status_reason": {
            "description": "Reason for the image's current status",
            "readOnly": true
          },
          "tripod_hide": {
            "description": "Whether to crop the bottom of 360-degree images to hide the tripod. Note: This performs a simple crop and does not use generative in-painting.",
            "nullable": true,
            "type": "boolean"
          },
          "upload_url": {
            "description": "The upload URL for the image to be uploaded to.",
            "readOnly": true
          },
          "upscale": {
            "description": "Whether to upscale the image.",
            "type": "boolean"
          },
          "user_id": {
            "description": "The user ID of the user who uploaded (owns) the image.",
            "readOnly": true
          },
          "window_pull_type": {
            "description": "What type of window pull to apply to the image (Available since AI version >= 4.0, WITH_SKIES can only be used from AI version 5.2 or higher).",
            "enum": [
              "NONE",
              "ONLY_WINDOWS",
              "WINDOWS_WITH_SKIES",
              null
            ],
            "nullable": true,
            "type": "string"
          }
        },
        "type": "object"
      },
      "ImageIn": {
        "additionalProperties": true,
        "properties": {
          "ai_version": {
            "description": "The version of the AI model to use for enhancing the image. Versions ending in an .x will use the latest minor version as soon as it's published.",
            "type": "string"
          },
          "cloud_type": {
            "description": "The type of clouds in the new sky to replace the original sky with. Options include: CLEAR, LOW_CLOUD, HIGH_CLOUD",
            "enum": [
              "CLEAR",
              "LOW_CLOUD",
              "HIGH_CLOUD",
              null
            ],
            "nullable": true,
            "type": "string"
          },
          "enhance": {
            "default": true,
            "description": "Whether to enhance the image.",
            "type": "boolean"
          },
          "finetune_settings": {
            "anyOf": [
              {
                "nullable": true,
                "type": "object"
              },
              {
                "$ref": "#/components/schemas/FinetuneOptions"
              }
            ]
          },
          "image_name": {
            "type": "string"
          },
          "lens_correction": {
            "default": true,
            "description": "Correct any lens distortion in the image.",
            "type": "boolean"
          },
          "metadata": {
            "additionalProperties": {},
            "description": "Metadata for the image.",
            "nullable": true,
            "type": "object"
          },
          "order_id": {
            "minLength": 1,
            "type": "string"
          },
          "perspective_correction": {
            "default": true,
            "description": "Enable perspective correction to straighten vertical and horizontal lines in the image.",
            "type": "boolean"
          },
          "perspective_correction_mode": {
            "description": "Controls how aggressively perspective correction is applied when enabled. Only used when perspective_correction is true. 'PRESERVE_CONTENT' prioritizes keeping original image contents intact with strict guardrails. 'PRIORITIZE_PERSPECTIVE' relaxes guardrails to enforce straight lines, accepting heavy cropping. If omitted, or explicitly sent as null, when perspective_correction is true, the AI uses its default behavior.",
            "enum": [
              "OFF",
              "DEFAULT_ENABLED",
              "PRESERVE_CONTENT",
              "PRIORITIZE_PERSPECTIVE",
              null
            ],
            "nullable": true,
            "type": "string"
          },
          "preset_id": {
            "description": "The ID of the preset to apply to the image.",
            "nullable": true,
            "type": "string"
          },
          "privacy": {
            "description": "Whether to blur any faces or license plates in the image.",
            "nullable": true,
            "type": "boolean"
          },
          "rating": {
            "description": "A rating between 0 and 5 on how good the image enhancement is. Higher is better.",
            "maximum": 5,
            "minimum": 0,
            "type": "integer"
          },
          "restage": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Restage"
              },
              {
                "nullable": true,
                "type": "object"
              }
            ],
            "description": "Restage options for in-painting or modifying scene elements. Allows correcting details like lighting a fireplace, removing fingerprints from a TV screen, or removing unwanted items like tripods."
          },
          "sky_replacement": {
            "description": "Enable the replacement of the original sky for a summer sky.",
            "type": "boolean"
          },
          "threesixty": {
            "description": "Whether the image is a 360 image.",
            "type": "boolean"
          },
          "tripod_hide": {
            "description": "Whether to crop the bottom of 360-degree images to hide the tripod. Note: This performs a simple crop and does not use generative in-painting.",
            "nullable": true,
            "type": "boolean"
          },
          "upscale": {
            "description": "Whether to upscale the image.",
            "type": "boolean"
          },
          "window_pull_type": {
            "description": "What type of window pull to apply to the image (Available since AI version >= 4.0, WITH_SKIES can only be used from AI version 5.2 or higher).",
            "enum": [
              "NONE",
              "ONLY_WINDOWS",
              "WINDOWS_WITH_SKIES",
              null
            ],
            "nullable": true,
            "type": "string"
          }
        },
        "required": [
          "image_name"
        ],
        "type": "object"
      },
      "ImageOut": {
        "additionalProperties": false,
        "properties": {
          "ai_version": {
            "description": "The version of the AI model to use for enhancing the image. Versions ending in an .x will use the latest minor version as soon as it's published.",
            "type": "string"
          },
          "cloud_type": {
            "description": "The type of clouds in the new sky to replace the original sky with. Options include: CLEAR, LOW_CLOUD, HIGH_CLOUD",
            "enum": [
              "CLEAR",
              "LOW_CLOUD",
              "HIGH_CLOUD",
              null
            ],
            "nullable": true,
            "type": "string"
          },
          "date_added": {
            "description": "The date the image was registered with Autoenhance.",
            "type": "integer"
          },
          "downloaded": {
            "description": "Whether the image has already been downloaded and paid for.",
            "type": "boolean"
          },
          "enhance": {
            "default": true,
            "description": "Whether to enhance the image.",
            "type": "boolean"
          },
          "finetune_settings": {
            "anyOf": [
              {
                "nullable": true,
                "type": "object"
              },
              {
                "$ref": "#/components/schemas/FinetuneOptions"
              }
            ]
          },
          "image_id": {
            "format": "uuid",
            "type": "string"
          },
          "image_name": {
            "type": "string"
          },
          "lens_correction": {
            "default": true,
            "description": "Correct any lens distortion in the image.",
            "type": "boolean"
          },
          "metadata": {
            "additionalProperties": {},
            "description": "Metadata for the image.",
            "type": "object"
          },
          "order_id": {
            "readOnly": true
          },
          "parent_image_id": {
            "description": "The ID of the parent image if this is a sub-image created for premium restaging. Null for original images.",
            "nullable": true,
            "type": "string"
          },
          "perspective_correction": {
            "description": "Whether perspective correction is enabled for the image.",
            "nullable": true,
            "type": "boolean"
          },
          "perspective_correction_mode": {
            "description": "The perspective correction mode used for the image. 'OFF' means disabled, 'DEFAULT_ENABLED' uses AI defaults, 'PRESERVE_CONTENT' prioritizes keeping content, 'PRIORITIZE_PERSPECTIVE' prioritizes straight lines.",
            "enum": [
              "OFF",
              "DEFAULT_ENABLED",
              "PRESERVE_CONTENT",
              "PRIORITIZE_PERSPECTIVE",
              null
            ],
            "nullable": true,
            "type": "string"
          },
          "preset_id": {
            "description": "The ID of the preset that was applied to the image.",
            "readOnly": true
          },
          "preset_version": {
            "description": "Preset version applied when the image was last processed with a preset.",
            "nullable": true,
            "readOnly": true
          },
          "privacy": {
            "description": "Whether to blur any faces or license plates in the image.",
            "nullable": true,
            "type": "boolean"
          },
          "rating": {
            "description": "A rating between 0 and 5 on how good the image enhancement is. Higher is better.",
            "maximum": 5,
            "minimum": 0,
            "type": "integer"
          },
          "restage": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Restage"
              },
              {
                "nullable": true,
                "type": "object"
              }
            ],
            "description": "Restage options for in-painting or modifying scene elements. Allows correcting details like lighting a fireplace, removing fingerprints from a TV screen, or removing unwanted items like tripods."
          },
          "scene": {
            "description": "The detected scene of the image, for example garden, patio or kitchen.",
            "type": "string"
          },
          "sky_replacement": {
            "description": "Whether the sky replacement feature was enabled for the image.",
            "type": "boolean"
          },
          "status": {
            "description": "The processing status of the image.",
            "readOnly": true
          },
          "status_reason": {
            "description": "Reason for the image's current status",
            "readOnly": true
          },
          "tripod_hide": {
            "description": "Whether to crop the bottom of 360-degree images to hide the tripod. Note: This performs a simple crop and does not use generative in-painting.",
            "nullable": true,
            "type": "boolean"
          },
          "upscale": {
            "description": "Whether to upscale the image.",
            "type": "boolean"
          },
          "user_id": {
            "description": "The user ID of the user who uploaded (owns) the image.",
            "readOnly": true
          },
          "window_pull_type": {
            "description": "What type of window pull to apply to the image (Available since AI version >= 4.0, WITH_SKIES can only be used from AI version 5.2 or higher).",
            "enum": [
              "NONE",
              "ONLY_WINDOWS",
              "WINDOWS_WITH_SKIES",
              null
            ],
            "nullable": true,
            "type": "string"
          }
        },
        "type": "object"
      },
      "OrderBracketsOut": {
        "additionalProperties": false,
        "properties": {
          "brackets": {
            "items": {
              "$ref": "#/components/schemas/BracketOut"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "OrderHDRImageIn": {
        "additionalProperties": false,
        "properties": {
          "bracket_ids": {
            "items": {
              "type": "string"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "OrderHDRProcessIn": {
        "properties": {
          "ai_version": {
            "description": "The version of the AI model to use for enhancing the image. Versions ending in an .x will use the latest minor version as soon as it's published.",
            "type": "string"
          },
          "cloud_type": {
            "description": "The type of clouds in the new sky to replace the original sky with. Options include: CLEAR, LOW_CLOUD, HIGH_CLOUD",
            "enum": [
              "CLEAR",
              "LOW_CLOUD",
              "HIGH_CLOUD",
              null
            ],
            "nullable": true,
            "type": "string"
          },
          "enhance": {
            "default": true,
            "description": "Whether to enhance the image.",
            "type": "boolean"
          },
          "finetune_settings": {
            "anyOf": [
              {
                "nullable": true,
                "type": "object"
              },
              {
                "$ref": "#/components/schemas/FinetuneOptions"
              }
            ]
          },
          "images": {
            "items": {
              "$ref": "#/components/schemas/OrderHDRImageIn"
            },
            "type": "array"
          },
          "lens_correction": {
            "default": true,
            "description": "Correct any lens distortion in the image.",
            "type": "boolean"
          },
          "number_of_brackets_per_image": {
            "description": "If provided then group into an image after every specified number of brackets, if not provided or set to 0 then images are grouped automatically based on visual analysis.",
            "type": "integer"
          },
          "perspective_correction": {
            "default": true,
            "description": "Enable perspective correction to straighten vertical and horizontal lines in the image.",
            "type": "boolean"
          },
          "perspective_correction_mode": {
            "description": "Controls how aggressively perspective correction is applied when enabled. Only used when perspective_correction is true. 'PRESERVE_CONTENT' prioritizes keeping original image contents intact with strict guardrails. 'PRIORITIZE_PERSPECTIVE' relaxes guardrails to enforce straight lines, accepting heavy cropping. If omitted, or explicitly sent as null, when perspective_correction is true, the AI uses its default behavior.",
            "enum": [
              "OFF",
              "DEFAULT_ENABLED",
              "PRESERVE_CONTENT",
              "PRIORITIZE_PERSPECTIVE",
              null
            ],
            "nullable": true,
            "type": "string"
          },
          "preset_id": {
            "nullable": true,
            "type": "string"
          },
          "privacy": {
            "description": "Whether to blur any faces or license plates in the image.",
            "nullable": true,
            "type": "boolean"
          },
          "restage": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Restage"
              },
              {
                "nullable": true,
                "type": "object"
              }
            ],
            "description": "Restage options for in-painting or modifying scene elements. Allows correcting details like lighting a fireplace, removing fingerprints from a TV screen, or removing unwanted items like tripods."
          },
          "sky_replacement": {
            "description": "Enable the replacement of the original sky for a summer sky.",
            "type": "boolean"
          },
          "tripod_hide": {
            "description": "Whether to crop the bottom of 360-degree images to hide the tripod. Note: This performs a simple crop and does not use generative in-painting.",
            "nullable": true,
            "type": "boolean"
          },
          "upscale": {
            "description": "Whether to upscale the image.",
            "type": "boolean"
          },
          "window_pull_type": {
            "description": "What type of window pull to apply to the image (Available since AI version >= 4.0, WITH_SKIES can only be used from AI version 5.2 or higher).",
            "enum": [
              "NONE",
              "ONLY_WINDOWS",
              "WINDOWS_WITH_SKIES",
              null
            ],
            "nullable": true,
            "type": "string"
          }
        },
        "type": "object"
      },
      "OrderHDRProcessOut": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "description": "The creation date of the order.",
            "format": "date-time",
            "type": "string"
          },
          "default_image_sort_order": {
            "description": "Default sort order for images in the order.",
            "enum": [
              "name",
              "-name",
              "date_added",
              "-date_added",
              "custom"
            ]
          },
          "images": {
            "description": "The list of images for the order.",
            "items": {
              "$ref": "#/components/schemas/ImageOut"
            },
            "type": "array"
          },
          "is_deleted": {
            "description": "Whether the order has been deleted.",
            "type": "boolean"
          },
          "is_merging": {
            "description": "Whether the order's brackets are currently being merged into images.",
            "type": "boolean"
          },
          "is_processing": {
            "description": "Whether the order still has images that have not finished processing.",
            "type": "boolean"
          },
          "last_updated_at": {
            "description": "The last updated date of the order.",
            "format": "date-time",
            "type": "string"
          },
          "name": {
            "description": "The name for the order.",
            "type": "string"
          },
          "order_id": {
            "description": "The ID for the order.",
            "type": "string"
          },
          "status": {
            "description": "The status of the order.",
            "readOnly": true
          },
          "total_images": {
            "description": "The number of images in the order.",
            "type": "number"
          }
        },
        "type": "object"
      },
      "OrderImageIn": {
        "additionalProperties": false,
        "properties": {
          "id": {
            "description": "The ID of the image to reorder.",
            "type": "string"
          },
          "index": {
            "description": "The new index of the image to reorder.",
            "type": "integer"
          }
        },
        "required": [
          "id",
          "index"
        ],
        "type": "object"
      },
      "OrderImagesIn": {
        "additionalProperties": false,
        "properties": {
          "images": {
            "description": "The list of images to reorder.",
            "example": [
              {
                "id": "image-id-1",
                "index": 0
              },
              {
                "id": "image-id-2",
                "index": 1
              }
            ],
            "items": {
              "$ref": "#/components/schemas/OrderImageIn"
            },
            "type": "array"
          }
        },
        "type": "object"
      },
      "OrderImagesOut": {
        "additionalProperties": false,
        "properties": {
          "images": {
            "description": "The list of images for the order.",
            "readOnly": true
          }
        },
        "type": "object"
      },
      "OrderIn": {
        "additionalProperties": false,
        "properties": {
          "default_image_sort_order": {
            "description": "Default sort order for images in the order. Prefix with '-' for descending order.",
            "enum": [
              "name",
              "-name",
              "date_added",
              "-date_added",
              "custom"
            ]
          },
          "name": {
            "description": "The name for the order.",
            "type": "string"
          },
          "order_id": {
            "description": "The ID for the order.",
            "minLength": 1,
            "type": "string"
          }
        },
        "type": "object"
      },
      "OrderOut": {
        "additionalProperties": false,
        "properties": {
          "created_at": {
            "description": "The creation date of the order.",
            "format": "date-time",
            "type": "string"
          },
          "default_image_sort_order": {
            "description": "Default sort order for images in the order.",
            "enum": [
              "name",
              "-name",
              "date_added",
              "-date_added",
              "custom"
            ]
          },
          "images": {
            "description": "The list of images for the order.",
            "items": {
              "$ref": "#/components/schemas/ImageOut"
            },
            "type": "array"
          },
          "is_deleted": {
            "description": "Whether the order has been deleted.",
            "type": "boolean"
          },
          "is_merging": {
            "description": "Whether the order's brackets are currently being merged into images.",
            "type": "boolean"
          },
          "is_processing": {
            "description": "Whether the order still has images that have not finished processing.",
            "type": "boolean"
          },
          "last_updated_at": {
            "description": "The last updated date of the order.",
            "format": "date-time",
            "type": "string"
          },
          "name": {
            "description": "The name for the order.",
            "type": "string"
          },
          "order_id": {
            "description": "The ID for the order.",
            "type": "string"
          },
          "status": {
            "description": "The status of the order.",
            "readOnly": true
          },
          "total_images": {
            "description": "The number of images in the order.",
            "type": "number"
          }
        },
        "type": "object"
      },
      "OrdersOut": {
        "additionalProperties": false,
        "properties": {
          "orders": {
            "items": {
              "$ref": "#/components/schemas/OrderOut"
            },
            "type": "array"
          },
          "pagination": {
            "$ref": "#/components/schemas/Pagination"
          }
        },
        "type": "object"
      },
      "Pagination": {
        "additionalProperties": false,
        "properties": {
          "next_offset": {
            "description": "The offset token for the next page of results or null if it is the last page. Pass this to the `offset` parameter when loading the next page.",
            "type": "string"
          },
          "per_page": {
            "default": 5,
            "description": "The amount of items per page of results.",
            "type": "integer"
          }
        },
        "type": "object"
      },
      "ReportIn": {
        "additionalProperties": false,
        "properties": {
          "categories": {
            "description": "A list of categories to be reported.",
            "items": {
              "enum": [
                "AUTO_PRIVACY",
                "COLOUR",
                "CONTRAST",
                "DOWNLOAD",
                "EXPOSURE",
                "HDR",
                "IMAGE_QUALITY",
                "ITEM_REMOVAL",
                "LENS_CORRECTION",
                "NO_COMPLAINTS",
                "NOISE",
                "OTHER",
                "PERSPECTIVE_CORRECTION",
                "PROCESSING",
                "SHARPNESS",
                "SKY_REPLACEMENT",
                "WHITE_BALANCE",
                "WINDOW_PULL",
                "DUSK",
                "GRASS",
                "TVS",
                "FIRE_IN_FIREPLACE",
                "PHOTOGRAPHER",
                "PRIVACY"
              ],
              "type": "string"
            },
            "minItems": 1,
            "type": "array"
          },
          "comment": {
            "description": "An optional comment to be sent along with the report.",
            "nullable": true,
            "type": "string"
          },
          "score": {
            "description": "A rating between 0 and 5 on how good the image enhancement is. Higher is better.",
            "maximum": 5,
            "minimum": 0,
            "type": "integer"
          },
          "severity": {
            "default": "MINOR",
            "description": "How badly the reported issues affect the image. Defaults to `MINOR`.",
            "enum": [
              "MINOR",
              "MAJOR",
              "UNUSABLE"
            ],
            "type": "string"
          },
          "source": {
            "enum": [
              "WEBAPP",
              "API",
              "ADMIN"
            ],
            "type": "string"
          }
        },
        "required": [
          "categories"
        ],
        "type": "object"
      },
      "Restage": {
        "properties": {
          "fire_in_fireplaces": {
            "description": "Controls the appearance of fireplaces. 'AS_SHOT' leaves the fireplace exactly as captured (e.g., unlit). 'ALIGHT' in-paints fire into the fireplace to make it appear active.",
            "enum": [
              "AS_SHOT",
              "ALIGHT",
              null
            ],
            "nullable": true,
            "type": "string"
          },
          "grass": {
            "description": "Controls grass appearance enhancement. 'AS_SHOT' leaves the grass exactly as captured. 'GREEN' applies grass greening to make brown/dead grass appear lush and green.",
            "enum": [
              "AS_SHOT",
              "GREEN",
              null
            ],
            "nullable": true,
            "type": "string"
          },
          "photographer": {
            "description": "Controls removal of photographer. 'AS_SHOT' leaves the photographer exactly as captured. 'REMOVE' removes the photographer including their shadow, reflection and hands.",
            "enum": [
              "AS_SHOT",
              "REMOVE",
              null
            ],
            "nullable": true,
            "type": "string"
          },
          "sky": {
            "description": "Controls sky replacement. 'AS_SHOT' keeps the original sky (no replacement). Any cloud type value replaces the sky with that cloud type. Cloud type options include: AS_SHOT, CLEAR, LOW_CLOUD, HIGH_CLOUD.",
            "enum": [
              "AS_SHOT",
              "CLEAR",
              "LOW_CLOUD",
              "HIGH_CLOUD",
              null
            ],
            "nullable": true,
            "type": "string"
          },
          "tvs": {
            "description": "Controls the appearance of television screens in the photo. 'AS_SHOT' leaves the TV screen exactly as captured. 'BLACK_OUT' in-paints the screen to appear completely black/off.",
            "enum": [
              "AS_SHOT",
              "BLACK_OUT",
              null
            ],
            "nullable": true,
            "type": "string"
          }
        },
        "type": "object"
      },
      "ValidationError": {
        "properties": {
          "detail": {
            "properties": {
              "<location>": {
                "properties": {
                  "<field_name>": {
                    "items": {
                      "type": "string"
                    },
                    "type": "array"
                  }
                },
                "type": "object"
              }
            },
            "type": "object"
          },
          "message": {
            "type": "string"
          }
        },
        "type": "object"
      }
    },
    "securitySchemes": {
      "ApiKeyAuth": {
        "in": "header",
        "name": "x-api-key",
        "type": "apiKey"
      }
    }
  },
  "info": {
    "description": "The Autoenhance API lets you upload property photos, enhance them with AI, merge bracketed exposures into HDR images, and download the results.\n\nAuthenticate every request by sending your API key in the `x-api-key` header. Most workflows create an order, upload images to it, and then download the enhanced images once processing completes.\n",
    "title": "Autoenhance API",
    "version": "2026-11-09"
  },
  "openapi": "3.0.3",
  "paths": {
    "/v3/brackets/": {
      "post": {
        "description": "Registers a bracket (one exposure of an HDR shot) on an order and returns an upload URL for the file.\n\nIf no order with the given `order_id` exists yet, it is created. If the order already has a bracket with\nthe same `name`, the new bracket is renamed with a `.copy-<number>` suffix so names stay unique within the order.\n\nOnce the bracket file is uploaded, call [Process an order](https://docs.autoenhance.ai/orders/grouping-brackets)\nto group the brackets and merge them into images.",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BracketIn"
              }
            }
          }
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BracketCreatedOut"
                }
              }
            },
            "description": "Successful response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPError"
                }
              }
            },
            "description": "Authentication error"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ValidationError"
                }
              }
            },
            "description": "Validation error"
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "Create a bracket",
        "tags": [
          "Brackets"
        ]
      }
    },
    "/v3/brackets/{bracket_id}": {
      "delete": {
        "description": "Deletes a bracket that has not been uploaded yet.\n\nReturns `400` if the bracket's file has already been uploaded, and `404` if the bracket does not exist.",
        "parameters": [
          {
            "in": "path",
            "name": "bracket_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPError"
                }
              }
            },
            "description": "Authentication error"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPError"
                }
              }
            },
            "description": "Not found"
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "Delete a bracket",
        "tags": [
          "Brackets"
        ]
      },
      "get": {
        "description": "Retrieves a bracket by its ID, including whether its file has finished uploading.\n\nReturns `404` if the bracket does not exist or belongs to another account.",
        "parameters": [
          {
            "in": "path",
            "name": "bracket_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BracketOut"
                }
              }
            },
            "description": "Successful response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPError"
                }
              }
            },
            "description": "Authentication error"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPError"
                }
              }
            },
            "description": "Not found"
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "Retrieve a bracket",
        "tags": [
          "Brackets"
        ]
      }
    },
    "/v3/images/": {
      "post": {
        "description": "Creates an image and returns an `upload_file_url` to upload the file to. Enhancement starts automatically\nonce the upload completes.\n\nProvide an `order_id` to add the image to an existing order, otherwise a new order is created. Settings such as\n`restage`, `enhance` and `preset_id` choose how the image is processed. Returns `404` if the preset does not exist.\nPremium restage settings, such as `environment`, can't be set when creating an image.",
        "operationId": "create_image",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ImageIn"
              }
            }
          }
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ImageCreatedOut"
                }
              }
            },
            "description": "Successful response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPError"
                }
              }
            },
            "description": "Authentication error"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ValidationError"
                }
              }
            },
            "description": "Validation error"
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "Create an image",
        "tags": [
          "Images"
        ]
      }
    },
    "/v3/images/{id}": {
      "delete": {
        "description": "Deletes an image. Returns `204` on success and `404` if the image does not exist or belongs to another account.",
        "operationId": "delete_image",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPError"
                }
              }
            },
            "description": "Authentication error"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPError"
                }
              }
            },
            "description": "Not found"
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "Delete an image",
        "tags": [
          "Images"
        ]
      },
      "get": {
        "description": "Retrieves an image by its ID, including its processing `status` and the settings used to enhance it.\nPoll this endpoint, or use webhooks, to find out when enhancement has finished.\n\nReturns `404` if the image does not exist.",
        "operationId": "retrieve_image",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ImageOut"
                }
              }
            },
            "description": "Successful response"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPError"
                }
              }
            },
            "description": "Not found"
          }
        },
        "summary": "Retrieve an image",
        "tags": [
          "Images"
        ]
      }
    },
    "/v3/images/{id}/enhanced": {
      "get": {
        "description": "Redirects to the enhanced image. If the image was restaged, the restaged version is returned unless you set\n`restaged` to `false`.\n\nThe first full-quality download of an image uses a credit. Previews and watermarked downloads are free.\nWhile the image is still being enhanced the response is `202` (`404` on API versions before `2025-05-08`).\nReturns `422` if enhancement failed. You can resize or re-encode the download with the query parameters.",
        "operationId": "download_enhanced_image",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "DPI of the image, must at least be 72.",
            "in": "query",
            "name": "dpi",
            "required": false,
            "schema": {
              "minimum": 72,
              "type": "integer"
            }
          },
          {
            "description": "Quality of the image, must be between 1 and 90.",
            "in": "query",
            "name": "quality",
            "required": false,
            "schema": {
              "maximum": 90,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "description": "Format of the image, must be one of 'avif', 'png', 'jpeg', 'jxl', or 'webp'.",
            "in": "query",
            "name": "format",
            "required": false,
            "schema": {
              "enum": [
                "avif",
                "png",
                "jpeg",
                "jxl",
                "webp"
              ],
              "type": "string"
            }
          },
          {
            "description": "Whether to show a lower quality preview version.",
            "in": "query",
            "name": "preview",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "description": "Whether to apply a watermark to the image.",
            "in": "query",
            "name": "watermark",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "description": "Whether to overlay an AI disclosure label on the image.",
            "in": "query",
            "name": "visible_disclosure",
            "required": false,
            "schema": {
              "default": false,
              "type": "boolean"
            }
          },
          {
            "description": "Whether to apply finetuning to the image.",
            "in": "query",
            "name": "finetuned",
            "required": false,
            "schema": {
              "default": null,
              "nullable": true,
              "type": "boolean"
            }
          },
          {
            "description": "Whether to apply finetuning to the image. Deprecated: use 'finetuned' instead.",
            "in": "query",
            "name": "finetune",
            "required": false,
            "schema": {
              "default": null,
              "nullable": true,
              "type": "boolean"
            }
          },
          {
            "description": "Whether to serve the restaged version of the image. Defaults to True (serve restaged if available). Set to False to serve the original enhanced image without restaging.",
            "in": "query",
            "name": "restaged",
            "required": false,
            "schema": {
              "default": true,
              "type": "boolean"
            }
          },
          {
            "description": "Maximum width of the image in pixels. Must be a positive integer.",
            "in": "query",
            "name": "max_width",
            "required": false,
            "schema": {
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "description": "Scale factor for the image, must be between 0.0 and 1.0.",
            "in": "query",
            "name": "scale",
            "required": false,
            "schema": {
              "maximum": 1.0,
              "minimum": 0.0,
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "image/jpeg": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": "Successful response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPError"
                }
              }
            },
            "description": "Authentication error"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPError"
                }
              }
            },
            "description": "Not found"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ValidationError"
                }
              }
            },
            "description": "Validation error"
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "Download the enhanced image",
        "tags": [
          "Images"
        ]
      }
    },
    "/v3/images/{id}/original": {
      "get": {
        "description": "Redirects to the image exactly as it was uploaded, as a JPEG. Downloading the original does not use a credit.\n\nWhile the image is still being enhanced the response is `202` (`404` on API versions before `2025-05-08`).\nReturns `422` if enhancement failed. You can resize or re-encode the download with the query parameters.",
        "operationId": "download_original_image",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "DPI of the image, must at least be 72.",
            "in": "query",
            "name": "dpi",
            "required": false,
            "schema": {
              "minimum": 72,
              "type": "integer"
            }
          },
          {
            "description": "Quality of the image, must be between 1 and 90.",
            "in": "query",
            "name": "quality",
            "required": false,
            "schema": {
              "maximum": 90,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "description": "Format of the image, must be one of 'avif', 'png', 'jpeg', 'jxl', or 'webp'.",
            "in": "query",
            "name": "format",
            "required": false,
            "schema": {
              "enum": [
                "avif",
                "png",
                "jpeg",
                "jxl",
                "webp"
              ],
              "type": "string"
            }
          },
          {
            "description": "Whether to show a lower quality preview version.",
            "in": "query",
            "name": "preview",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "description": "Whether to apply a watermark to the image.",
            "in": "query",
            "name": "watermark",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "description": "Whether to overlay an AI disclosure label on the image.",
            "in": "query",
            "name": "visible_disclosure",
            "required": false,
            "schema": {
              "default": false,
              "type": "boolean"
            }
          },
          {
            "description": "Whether to apply finetuning to the image.",
            "in": "query",
            "name": "finetuned",
            "required": false,
            "schema": {
              "default": null,
              "nullable": true,
              "type": "boolean"
            }
          },
          {
            "description": "Whether to apply finetuning to the image. Deprecated: use 'finetuned' instead.",
            "in": "query",
            "name": "finetune",
            "required": false,
            "schema": {
              "default": null,
              "nullable": true,
              "type": "boolean"
            }
          },
          {
            "description": "Whether to serve the restaged version of the image. Defaults to True (serve restaged if available). Set to False to serve the original enhanced image without restaging.",
            "in": "query",
            "name": "restaged",
            "required": false,
            "schema": {
              "default": true,
              "type": "boolean"
            }
          },
          {
            "description": "Maximum width of the image in pixels. Must be a positive integer.",
            "in": "query",
            "name": "max_width",
            "required": false,
            "schema": {
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "description": "Scale factor for the image, must be between 0.0 and 1.0.",
            "in": "query",
            "name": "scale",
            "required": false,
            "schema": {
              "maximum": 1.0,
              "minimum": 0.0,
              "type": "number"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "image/jpeg": {
                "schema": {
                  "format": "binary",
                  "type": "string"
                }
              }
            },
            "description": "Successful response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPError"
                }
              }
            },
            "description": "Authentication error"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPError"
                }
              }
            },
            "description": "Not found"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ValidationError"
                }
              }
            },
            "description": "Validation error"
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "Download the original image",
        "tags": [
          "Images"
        ]
      }
    },
    "/v3/images/{id}/report": {
      "post": {
        "description": "Reports a problem with an enhanced image so the Autoenhance team can review it. Send one or more `categories`\nand, optionally, a `comment` describing the problem.\n\nReturns `404` if the image does not exist.",
        "operationId": "report_image",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReportIn"
              }
            }
          }
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPError"
                }
              }
            },
            "description": "Authentication error"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPError"
                }
              }
            },
            "description": "Not found"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ValidationError"
                }
              }
            },
            "description": "Validation error"
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "Report an image",
        "tags": [
          "Images"
        ]
      }
    },
    "/v3/orders/": {
      "get": {
        "description": "Lists your orders, most recent first by default.\n\n- `q` filters orders by name.\n- `sort` orders results by `name` or `date`. Prefix with `-` for descending order, for example `-date`.\n- `per_page` sets how many orders are returned per page, and `offset` continues from the `next_offset` value of the previous page.",
        "operationId": "list_orders",
        "parameters": [
          {
            "description": "The offset token used to indicate which page of results to use.",
            "in": "query",
            "name": "offset",
            "required": false,
            "schema": {
              "default": "0",
              "type": "string"
            }
          },
          {
            "description": "The amount of items to be loaded per page of results. The final response may have a smaller number than requested if too large.",
            "in": "query",
            "name": "per_page",
            "required": false,
            "schema": {
              "default": 5,
              "maximum": 15,
              "type": "integer"
            }
          },
          {
            "description": "Free-text search term applied to order name. If omitted or empty, no search filter is applied.",
            "in": "query",
            "name": "q",
            "required": false,
            "schema": {
              "default": null,
              "nullable": true,
              "type": "string"
            }
          },
          {
            "description": "Sorting key with optional '-' prefix for descending order. Allowed values: 'name' (sort by name ascending), '-name' (sort by name descending), 'date' (sort by created_at ascending), '-date' (sort by created_at descending). If omitted or invalid, defaults to '-date' (most recent first).",
            "in": "query",
            "name": "sort",
            "required": false,
            "schema": {
              "default": "-date",
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrdersOut"
                }
              }
            },
            "description": "Successful response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPError"
                }
              }
            },
            "description": "Authentication error"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ValidationError"
                }
              }
            },
            "description": "Validation error"
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "List orders",
        "tags": [
          "Orders"
        ]
      },
      "post": {
        "description": "Creates an empty order to hold images or brackets. Provide your own `order_id` to look the order up by an ID\nfrom your system, otherwise one is generated.\n\nReturns `409` if an order with that `order_id` already exists.",
        "operationId": "create_order",
        "parameters": [],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OrderIn"
              }
            }
          }
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Successful response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPError"
                }
              }
            },
            "description": "Authentication error"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ValidationError"
                }
              }
            },
            "description": "Validation error"
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "Create an order",
        "tags": [
          "Orders"
        ]
      }
    },
    "/v3/orders/{id}": {
      "delete": {
        "description": "Deletes an order. Returns `204` on success and `404` if the order does not exist.",
        "operationId": "delete_order",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "204": {
            "description": "No Content"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPError"
                }
              }
            },
            "description": "Authentication error"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPError"
                }
              }
            },
            "description": "Not found"
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "Delete an order",
        "tags": [
          "Orders"
        ]
      },
      "get": {
        "description": "Retrieves an order by its ID, including its images and processing status.\n\nUse the `sort_images_by` query parameter to control the order of the returned images.\nReturns `404` if the order does not exist.",
        "operationId": "retrieve_order",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Specifies sort order for images in the order",
            "in": "query",
            "name": "sort_images_by",
            "required": false,
            "schema": {
              "enum": [
                "name",
                "-name",
                "date_added",
                "-date_added",
                "custom"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrderOut"
                }
              }
            },
            "description": "Successful response"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPError"
                }
              }
            },
            "description": "Not found"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ValidationError"
                }
              }
            },
            "description": "Validation error"
          }
        },
        "summary": "Retrieve an order",
        "tags": [
          "Orders"
        ]
      },
      "patch": {
        "description": "Updates the details of an order, such as its name. Only the fields you send are changed.\n\nUse the `sort_images_by` query parameter to control the order of the returned images.\nReturns `404` if the order does not exist.",
        "operationId": "update_order",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Specifies sort order for images in the order",
            "in": "query",
            "name": "sort_images_by",
            "required": false,
            "schema": {
              "enum": [
                "name",
                "-name",
                "date_added",
                "-date_added",
                "custom"
              ]
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OrderIn"
              }
            }
          }
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrderOut"
                }
              }
            },
            "description": "Successful response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPError"
                }
              }
            },
            "description": "Authentication error"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPError"
                }
              }
            },
            "description": "Not found"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ValidationError"
                }
              }
            },
            "description": "Validation error"
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "Update an order",
        "tags": [
          "Orders"
        ]
      }
    },
    "/v3/orders/{id}/images": {
      "patch": {
        "description": "Moves each listed image to the position given by its `index` (starting at 0). Images you don't list keep their\nrelative order. After this call the order's default image sort order becomes `custom`.\n\nIf you also pass `sort_images_by`, the images are sorted by that field first and your moves are applied on top.\nReturns `404` if the order does not exist.",
        "operationId": "update_order_images",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "description": "Specifies sort order for images in the order",
            "in": "query",
            "name": "sort_images_by",
            "required": false,
            "schema": {
              "enum": [
                "name",
                "-name",
                "date_added",
                "-date_added",
                "custom"
              ]
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OrderImagesIn"
              }
            }
          }
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrderImagesOut"
                }
              }
            },
            "description": "Successful response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPError"
                }
              }
            },
            "description": "Authentication error"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPError"
                }
              }
            },
            "description": "Not found"
          },
          "409": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPError"
                }
              }
            },
            "description": "Conflict"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ValidationError"
                }
              }
            },
            "description": "Validation error"
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "Reorder an order's images",
        "tags": [
          "Orders"
        ]
      }
    },
    "/v3/orders/{id}/process": {
      "post": {
        "description": "Groups the uploaded brackets into images and starts enhancing every image in the order.\n\nGrouping uses `number_of_brackets_per_image` when you provide it, or an explicit list of `images`, but not both.\nWithout either, brackets are grouped automatically from visual analysis. Processing is asynchronous: poll\n[Retrieve an order](https://docs.autoenhance.ai/orders) or use webhooks to find out when the images are ready.",
        "operationId": "process_order",
        "parameters": [
          {
            "in": "path",
            "name": "id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/OrderHDRProcessIn"
              }
            }
          }
        },
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrderHDRProcessOut"
                }
              }
            },
            "description": "Successful response"
          },
          "401": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPError"
                }
              }
            },
            "description": "Authentication error"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPError"
                }
              }
            },
            "description": "Not found"
          },
          "422": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ValidationError"
                }
              }
            },
            "description": "Validation error"
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "summary": "Process an order",
        "tags": [
          "Orders"
        ]
      }
    },
    "/v3/orders/{order_id}/brackets": {
      "get": {
        "description": "Retrieves the brackets uploaded to an order, so you can check which files have finished uploading before\nprocessing the order.\n\nReturns `404` if the order does not exist.",
        "parameters": [
          {
            "in": "path",
            "name": "order_id",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OrderBracketsOut"
                }
              }
            },
            "description": "Successful response"
          },
          "404": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HTTPError"
                }
              }
            },
            "description": "Not found"
          }
        },
        "summary": "Retrieve an order's brackets",
        "tags": [
          "Orders"
        ]
      }
    }
  },
  "servers": [
    {
      "url": "https://api.autoenhance.ai"
    }
  ],
  "tags": [
    {
      "description": "A bracket is one exposure of an HDR shot. Process the order to group brackets and merge them into images. See [grouping brackets](https://docs.autoenhance.ai/orders/grouping-brackets).",
      "name": "Brackets"
    },
    {
      "description": "An image is a single photo to enhance. Create it, upload the file, then download the result. See the [images guide](https://docs.autoenhance.ai/images).",
      "name": "Images"
    },
    {
      "description": "An order is a collection of images, usually one property listing. See the [orders guide](https://docs.autoenhance.ai/orders).",
      "name": "Orders"
    }
  ]
}
