{
  "openapi": "3.0.0",
  "info": {
    "title": "YGO API",
    "version": "2.0.0",
    "description": "The public YGO API (/v2/project), as documented on https://docs.ygo.ai. Generated from the same specs as the documentation pages."
  },
  "servers": [
    {
      "url": "https://api.ygo.ai",
      "description": "Production and Sandbox (determined by API key)"
    }
  ],
  "paths": {
    "/v2/project/content/acceptApprovalImageUpload": {
      "post": {
        "summary": "Accept approval image upload",
        "description": "Accept one pending photo upload: the photo becomes an image of the hotel and is appended to the approval page's photo list, and the upload's feedback item is resolved. The page serves it from the next `get`. When the hotel has no list yet, the photo is appended to the photos the page serves now, which then become its list.\n\nAccept checks, in order: hotel photo uploads are enabled for the project (400 `INVALID_STATUS_TRANSITION` otherwise, because an accepted photo would never be served; ask YGO support to enable them); hotel photo uploads are not switched off for the project (400 `INVALID_STATUS_TRANSITION` otherwise; contact YGO support); and the page's photo list can be read (503). The write then locks the upload and refuses one whose stored photo record is incomplete and cannot be read (400 `INVALID_STATUS_TRANSITION`; contact YGO support), an upload that is no longer pending (400 `INVALID_STATUS_TRANSITION`), a photo whose URL is not an Uploadcare CDN file URL `https://ucarecdn.com/<uuid>/` (400 `VALIDATION_ERROR` on `FeedbackID`; uploadImage records no other form), a list that changed since it was read (400 `INVALID_STATUS_TRANSITION`), a list that would hold more than 10 photos (400 `INVALID_STATUS_TRANSITION`) and a list that holds a photo that can no longer be listed (400 `VALIDATION_ERROR` on `FeedbackID`, field code `CONFLICT`). Works after the hotel approved. The reviewer is recorded as the user's ID, or `project:<project id>` for a project API key.",
        "operationId": "acceptApprovalImageUpload",
        "tags": [
          "Content Enrichment API/Approval Links"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AcceptApprovalImageUploadRequest"
              },
              "examples": {
                "accept": {
                  "summary": "Accept one pending upload",
                  "value": {
                    "HotelID": "019d9c2e-0ef8-7458-b0fa-8bed7182eb30",
                    "FeedbackID": "01a0f1c9-3e8a-7c12-b4d5-8e9f0a1b2c3d"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The accepted upload, `Status` `accepted` with its `ReviewedAt`.",
            "headers": {
              "X-Trace-ID": {
                "$ref": "#/components/headers/X-Trace-ID"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AcceptApprovalImageUploadResponse"
                },
                "examples": {
                  "accept": {
                    "summary": "The photo is on the page's list",
                    "value": {
                      "Data": {
                        "ID": "01a0f1c9-3e8a-7c12-b4d5-8e9f0a1b2c3d",
                        "HotelID": "019d9c2e-0ef8-7458-b0fa-8bed7182eb30",
                        "URL": "https://ucarecdn.com/8f14e45f-ceea-467a-9575-7d3b1c2a9e10/",
                        "Width": 1600,
                        "Height": 1200,
                        "FileSize": 0,
                        "Format": "",
                        "Status": "accepted",
                        "CreatedAt": "2026-10-12T09:14:03.512874Z",
                        "ReviewedAt": "2026-10-12T11:02:39.660142Z"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/InternalServerError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Project-ID"
          }
        ]
      }
    },
    "/v2/project/content/addTagToHotels": {
      "post": {
        "summary": "Add tag to hotels (bulk)",
        "description": "Add a project tag to up to 1000 hotels at once. Tag ownership is checked once (404 if foreign). Each hotel id passes the project-membership escalation guard: a live member is 'applied', a non-member is 'skipped_not_member' (never tagged), a malformed id is 'invalid'. Returns the per-hotel outcomes.",
        "operationId": "addTagToHotels",
        "tags": [
          "Content Enrichment API/Tags"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Project-ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AddTagToHotelsRequest"
              },
              "examples": {
                "bulk": {
                  "summary": "Apply a tag to several hotels",
                  "value": {
                    "TagID": "0192fc01-1111-7abc-8def-aaaaaaaaaaaa",
                    "HotelIDs": [
                      "0192fb17-5dc6-7abc-8def-123456789abc",
                      "0192fb18-6ed7-7abc-8def-223456789abc"
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Bulk add processed. Each hotel id carries its own outcome.",
            "headers": {
              "X-Trace-ID": {
                "$ref": "#/components/headers/X-Trace-ID"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AddTagToHotelsResponse"
                },
                "examples": {
                  "bulk": {
                    "summary": "A mixed batch: one applied, one skipped, one invalid",
                    "value": {
                      "Data": {
                        "TagID": "0192fc01-1111-7abc-8def-aaaaaaaaaaaa",
                        "Results": [
                          {
                            "HotelID": "0192fb17-5dc6-7abc-8def-123456789abc",
                            "Status": "applied"
                          },
                          {
                            "HotelID": "0192fb18-6ed7-7abc-8def-223456789abc",
                            "Status": "skipped_not_member"
                          },
                          {
                            "HotelID": "not-a-uuid",
                            "Status": "invalid"
                          }
                        ]
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/addTagToHotels_BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/addTagToHotels_Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/addTagToHotels_Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/addTagToHotels_NotFound"
          },
          "429": {
            "$ref": "#/components/responses/addTagToHotels_TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/addTagToHotels_InternalServerError"
          }
        }
      }
    },
    "/v2/project/content/createApprovalLinks": {
      "post": {
        "summary": "Create approval links (bulk)",
        "description": "Mint one approval link per requested hotel that does not have a live one, and return the link of every requested member hotel in request order. The operation is idempotent: a hotel that already has a live link keeps it, token unchanged, so calling this again never invalidates a link that has already been sent out. A hotel whose link was REVOKED gets a fresh token instead — with `Created` true, its `Status` back to `waiting_for_hotel` (a new link means \"look at this again\"), and `ApprovedAt`, `ApprovedBy` and `ApprovedTextGeneratedAt` kept as the record of what was approved — which makes this the way back to a live link after a revoke. `Created` distinguishes minted from untouched per row. Hotel ids that are not live members of the project are skipped and echoed in `NotInProjectIDs`.",
        "operationId": "createApprovalLinks",
        "tags": [
          "Content Enrichment API/Approval Links"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateApprovalLinksRequest"
              },
              "examples": {
                "twoHotels": {
                  "summary": "Mint links for two member hotels",
                  "value": {
                    "HotelIDs": [
                      "019d9c2e-0ef8-7458-b0fa-8bed7182eb30",
                      "019d9c23-1238-7334-bf02-4c45c50e033a"
                    ]
                  }
                },
                "withNonMember": {
                  "summary": "One of the ids is not in the project",
                  "value": {
                    "HotelIDs": [
                      "019d9c2e-0ef8-7458-b0fa-8bed7182eb30",
                      "019e4afb-e973-764c-9bb1-a4c66175e08b",
                      "019d9c23-1238-7334-bf02-4c45c50e033a"
                    ]
                  }
                },
                "afterRevoke": {
                  "summary": "Mint a fresh link for a hotel whose link was revoked",
                  "value": {
                    "HotelIDs": [
                      "019d9c2e-0ef8-7458-b0fa-8bed7182eb30"
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The approval links of every requested member hotel, in request order.",
            "headers": {
              "X-Trace-ID": {
                "$ref": "#/components/headers/X-Trace-ID"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CreateApprovalLinksResponse"
                },
                "examples": {
                  "twoHotels": {
                    "summary": "Two links minted",
                    "value": {
                      "Data": [
                        {
                          "HotelID": "019d9c2e-0ef8-7458-b0fa-8bed7182eb30",
                          "HotelName": "Sotavento Beach Club",
                          "GiataID": 5721,
                          "MasterCode": "FUED0009",
                          "Token": "xPBOjXHomqBvKZ0nQ2sT7yWlR4dGuAeIcNvXbF9pMk3",
                          "TokenPreview": "xPBOjXHo...",
                          "Status": "waiting_for_hotel",
                          "Created": true,
                          "CreatedBy": "editor@example.com",
                          "CreatedAt": "2026-08-25T18:19:17.522006Z",
                          "UpdatedAt": "2026-08-25T18:19:17.522006Z"
                        },
                        {
                          "HotelID": "019d9c23-1238-7334-bf02-4c45c50e033a",
                          "HotelName": "JAZ Makadina",
                          "GiataID": 16706,
                          "MasterCode": "HRGD0238",
                          "Token": "QxIpAvQhJ8rLzTd5oYuN1kSbVe6HcWfMg0iRnJ2aPtE",
                          "TokenPreview": "QxIpAvQh...",
                          "Status": "waiting_for_hotel",
                          "Created": true,
                          "CreatedBy": "editor@example.com",
                          "CreatedAt": "2026-08-25T18:19:17.522006Z",
                          "UpdatedAt": "2026-08-25T18:19:17.522006Z"
                        }
                      ]
                    }
                  },
                  "withNonMember": {
                    "summary": "Two links minted, the non-member id echoed back",
                    "value": {
                      "Data": [
                        {
                          "HotelID": "019d9c2e-0ef8-7458-b0fa-8bed7182eb30",
                          "HotelName": "Sotavento Beach Club",
                          "GiataID": 5721,
                          "MasterCode": "FUED0009",
                          "Token": "xPBOjXHomqBvKZ0nQ2sT7yWlR4dGuAeIcNvXbF9pMk3",
                          "TokenPreview": "xPBOjXHo...",
                          "Status": "waiting_for_hotel",
                          "Created": true,
                          "CreatedBy": "editor@example.com",
                          "CreatedAt": "2026-08-25T18:19:17.522006Z",
                          "UpdatedAt": "2026-08-25T18:19:17.522006Z"
                        },
                        {
                          "HotelID": "019d9c23-1238-7334-bf02-4c45c50e033a",
                          "HotelName": "JAZ Makadina",
                          "GiataID": 16706,
                          "MasterCode": "HRGD0238",
                          "Token": "QxIpAvQhJ8rLzTd5oYuN1kSbVe6HcWfMg0iRnJ2aPtE",
                          "TokenPreview": "QxIpAvQh...",
                          "Status": "waiting_for_hotel",
                          "Created": true,
                          "CreatedBy": "editor@example.com",
                          "CreatedAt": "2026-08-25T18:19:17.522006Z",
                          "UpdatedAt": "2026-08-25T18:19:17.522006Z"
                        }
                      ],
                      "NotInProjectIDs": [
                        "019e4afb-e973-764c-9bb1-a4c66175e08b"
                      ]
                    }
                  },
                  "afterRevoke": {
                    "summary": "A revoked link re-minted: new token, Created true, status back to waiting_for_hotel, the approval record kept",
                    "value": {
                      "Data": [
                        {
                          "HotelID": "019d9c2e-0ef8-7458-b0fa-8bed7182eb30",
                          "HotelName": "Sotavento Beach Club",
                          "GiataID": 5721,
                          "MasterCode": "FUED0009",
                          "Token": "tN4kQz8YbLm2VrXe7WcJd1SgHfU5oApIyB6nEt0RqZ3",
                          "TokenPreview": "tN4kQz8Y...",
                          "Status": "waiting_for_hotel",
                          "ApprovedAt": "2026-08-25T18:19:18.860882Z",
                          "ApprovedTextGeneratedAt": "2026-08-19T14:14:57.674681Z",
                          "ApprovedBy": {
                            "Name": "Ayşe Yılmaz",
                            "Email": "ayse@sotavento.example",
                            "Phone": "+34 928 000 000"
                          },
                          "LastOpenedAt": "2026-08-25T18:19:18.966928Z",
                          "Created": true,
                          "CreatedBy": "editor@example.com",
                          "CreatedAt": "2026-08-25T18:19:17.522006Z",
                          "UpdatedAt": "2026-08-25T18:19:20.114377Z"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/createApprovalLinks_BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/createApprovalLinks_NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/createApprovalLinks_InternalServerError"
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Project-ID"
          }
        ]
      }
    },
    "/v2/project/content/deleteHotelImagePin": {
      "post": {
        "summary": "Delete hotel image pin",
        "description": "Clear the project's pinned first image for a hotel, restoring the default gallery order. Idempotent: clearing a hotel with no pin succeeds. The hotel must be a live member of the calling project (same guard as saveHotelImagePin); a non-member returns 404.",
        "operationId": "deleteHotelImagePin",
        "tags": [
          "Content Enrichment API/Image Pins"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Project-ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DeleteHotelImagePinRequest"
              },
              "examples": {
                "clearPin": {
                  "summary": "Clear the pin for a hotel",
                  "value": {
                    "HotelID": "0192fb17-5dc6-7abc-8def-123456789abc"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Pin cleared successfully (or the hotel had no pin).",
            "headers": {
              "X-Trace-ID": {
                "$ref": "#/components/headers/X-Trace-ID"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeleteHotelImagePinResponse"
                },
                "examples": {
                  "clearPin": {
                    "summary": "The hotel whose pin was cleared",
                    "value": {
                      "Data": {
                        "HotelID": "0192fb17-5dc6-7abc-8def-123456789abc"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/deleteHotelImagePin_BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/deleteHotelImagePin_Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/deleteHotelImagePin_Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/deleteHotelImagePin_NotFound"
          },
          "429": {
            "$ref": "#/components/responses/deleteHotelImagePin_TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/deleteHotelImagePin_InternalServerError"
          }
        }
      }
    },
    "/v2/project/content/deleteHotelStars": {
      "post": {
        "summary": "Delete hotel stars",
        "description": "Remove your project's own star grade for one hotel; StarsMap.project disappears and StarsMap.default, with the top-level Stars, falls back to the next source (normally on the next read, at the latest about a minute later). Idempotent: clearing a hotel with no grade succeeds. The hotel must belong to the calling project (same guard as saveHotelStars); a hotel outside the project returns 404.",
        "operationId": "deleteHotelStars",
        "tags": [
          "Content Enrichment API/Hotel Stars"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Project-ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DeleteHotelStarsRequest"
              },
              "examples": {
                "clearGrade": {
                  "summary": "Clear the grade for a hotel",
                  "value": {
                    "HotelID": "0192fb17-5dc6-7abc-8def-123456789abc"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Grade cleared (or the hotel had no grade).",
            "headers": {
              "X-Trace-ID": {
                "$ref": "#/components/headers/X-Trace-ID"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeleteHotelStarsResponse"
                },
                "examples": {
                  "clearGrade": {
                    "summary": "The hotel whose grade was cleared",
                    "value": {
                      "Data": {
                        "HotelID": "0192fb17-5dc6-7abc-8def-123456789abc",
                        "Cleared": true
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/deleteHotelStars_BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/deleteHotelStars_Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/deleteHotelStars_Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/deleteHotelStars_NotFound"
          },
          "429": {
            "$ref": "#/components/responses/deleteHotelStars_TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/deleteHotelStars_InternalServerError"
          }
        }
      }
    },
    "/v2/project/content/deleteTag": {
      "post": {
        "summary": "Delete tag",
        "description": "Delete a project tag by its UUID. The tag's hotel links cascade away with it; the hotels and their membership are untouched. A tag not in the project returns 404.",
        "operationId": "deleteTag",
        "tags": [
          "Content Enrichment API/Tags"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Project-ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DeleteTagRequest"
              },
              "examples": {
                "byTagID": {
                  "summary": "Delete a tag by its UUID",
                  "value": {
                    "TagID": "0192fc01-1111-7abc-8def-aaaaaaaaaaaa"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tag deleted successfully.",
            "headers": {
              "X-Trace-ID": {
                "$ref": "#/components/headers/X-Trace-ID"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeleteTagResponse"
                },
                "examples": {
                  "byTagID": {
                    "summary": "The deleted tag's id and project id",
                    "value": {
                      "Data": {
                        "ID": "0192fc01-1111-7abc-8def-aaaaaaaaaaaa",
                        "ProjectID": "0192fa00-0000-7abc-8def-000000000000"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/deleteTag_BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/deleteTag_Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/deleteTag_Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/deleteTag_NotFound"
          },
          "429": {
            "$ref": "#/components/responses/deleteTag_TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/deleteTag_InternalServerError"
          }
        }
      }
    },
    "/v2/project/content/exportApprovedHotelText": {
      "post": {
        "summary": "Export approved hotel text with image URLs",
        "description": "Download one hotel's approved catalog text, followed by the image URLs its approval page serves, as a `.txt` file. The response body is the file itself (`text/plain; charset=utf-8`), not a JSON envelope, and the `Content-Disposition` header carries one ASCII name: hotel slug, locale, approval date. The file contains the generated texts the hotel's approval page served in the project's default locale, verbatim and in page order, under a framed metadata block that no layout would mistake for copy, then the served image URLs in the approval page's order in a block of their own. A hotel that has not approved is refused with 409 `NOT_APPROVED`, and so is a hotel whose text was regenerated after its approval: what leaves is byte for byte the approved text, never the live text. When the project's `Content.ApprovalTextKeys` setting lists template keys, only texts with a listed key are exported, rule texts included. The call writes nothing to the approval tables and, like the approval page, neither reads nor writes the shared enriched-hotel cache. \n\nThe file is REFUSED with 500 `INTERNAL_ERROR` when any read it certifies fails, rather than served with the missing part silently absent. A 500 also answers one INVARIANT violation: an approval row marked approved that carries no approval time (\"Approval record has no approval time\"). The file's `Approved:` line and its download name are both built from that timestamp, so the export refuses rather than invent a date. It is corrupt data rather than a client state, which is why it is a 500 and not a 409, and no request can cause or clear it. The reads are: the hotel's generated texts (message \"Failed to load hotel texts\"); and, all under \"Failed to load the hotel's images and identifiers\", the pinned image, the project master code, the project's ordered approval image list for the hotel (with the rows and fingerprints of the images on it), the provider registry, the per-image ownership check, the hotel's room list, a room's image rows, the hotel's own image rows, the image fingerprints those rows point at, and the crop groups that collapse near-duplicate images. Each of these would otherwise change the file silently — a missing master code simply omits the `ProductID` line, a missing fingerprint read leaves every image without the category the gallery rule sorts on — so one approval could yield two different files on either side of a transient error. The hotel's own approval page keeps rendering through the image and identifier reads, because it displays rather than certifies. The generated-texts read is the exception: the approval page and the hotel's own approve refuse with the same 500 rather than show, or record consent to, a half-rendered page. Nothing is wrong with the hotel's text or its approval in that case: download again once the failing read recovers.",
        "operationId": "exportApprovedHotelText",
        "tags": [
          "Content Enrichment API/Approval Links"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ExportApprovedHotelTextRequest"
              },
              "examples": {
                "approvedText": {
                  "summary": "Export one hotel",
                  "value": {
                    "HotelID": "019f412f-c41c-746e-b569-e6454677366c"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The approved catalog text file, with the served image URLs. The body is the file itself, not a JSON envelope.",
            "headers": {
              "Content-Disposition": {
                "description": "Download name of the file: one ASCII `filename` — hotel slug, served locale, approval date (UTC day) — and no `filename*` form.",
                "schema": {
                  "type": "string",
                  "example": "attachment; filename=\"neptune-luxury-resort_de-DE_2026-08-27.txt\""
                }
              },
              "Content-Length": {
                "description": "Size of the file in bytes. Always set explicitly; the body is never content-encoded.",
                "schema": {
                  "type": "integer",
                  "example": 1020
                }
              },
              "Cache-Control": {
                "description": "Always `no-store`: the file is one project's content, named after its hotel.",
                "schema": {
                  "type": "string",
                  "example": "no-store"
                }
              },
              "X-Trace-ID": {
                "$ref": "#/components/headers/X-Trace-ID"
              },
              "X-Content-Type-Options": {
                "description": "Always `nosniff`: the body is a text file and is never to be sniffed into anything else.",
                "schema": {
                  "type": "string",
                  "example": "nosniff"
                }
              }
            },
            "content": {
              "text/plain": {
                "schema": {
                  "$ref": "#/components/schemas/ApprovedHotelTextFile"
                },
                "examples": {
                  "approvedText": {
                    "summary": "The approved text in the project's default locale, then the served image URLs",
                    "value": "==================================================================\n APPROVED CATALOG TEXT - METADATA (not part of the text, do not paste)\n Hotel:         Neptune Luxury Resort\n GIATA:         741\n ProductID:     NEP-KOS-01\n Locale:        de-DE\n Approved:      2026-08-27T13:50:10Z by Ayşe Yılmaz\n Text version:  2026-08-19T14:15:29Z\n Images:        3\n AI notice:     This text is AI-generated (EU AI Act Art. 50(2))\n==================================================================\n--- BEGIN APPROVED TEXT ---\n\n[Summary]\nNeptune Luxury Resort ist ein **5-Sterne-Resort in Familienbesitz direkt am Strand**, das sich in Mastichari auf der Insel Kos befindet. Die 1989 gegründete Unterkunft liegt inmitten weitläufig angelegter Themengärten direkt an einem privaten, abgelegenen Sandstrand.\n\n[Highlights]\n- Privater Sandstrand in ruhiger Lage\n- Weitläufig angelegte Themengärten\n- Außergewöhnliche Sauberkeit in der gesamten Anlage\n\n[GuestPolicies]\nCheck-in ab 15:00 Uhr, Check-out bis 11:00 Uhr. Haustiere sind nicht gestattet.\n\n--- END APPROVED TEXT ---\n\n--- BEGIN IMAGE URLS (in the order the approval page serves them) ---\n1. https://images.ygo.ai/hotels/019f412f-c41c-746e-b569-e6454677366c/3f9a2c7e.jpg\n2. https://images.ygo.ai/hotels/019f412f-c41c-746e-b569-e6454677366c/b71d04e2.jpg\n3. https://images.ygo.ai/hotels/019f412f-c41c-746e-b569-e6454677366c/9c4e61aa.jpg\n--- END IMAGE URLS ---\n"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/exportApprovedHotelText_BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/exportApprovedHotelText_Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/exportApprovedHotelText_NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/exportApprovedHotelText_InternalServerError"
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Project-ID"
          }
        ]
      }
    },
    "/v2/project/content/generateText": {
      "post": {
        "summary": "Generate text",
        "description": "Queue an asynchronous text-generation run for a selection of the project's hotels and return the created run object.\n\nThe run starts in the `queued` state and is processed in the background. Use the returned run `ID` with `getTextGenerationStatus` to poll its status and progress until it reaches `complete` or `failed`.\n\nHotels are selected by `HotelIDs` and/or `TagIDs` (combined and deduplicated, capped at 100), and every selected hotel must belong to the calling project. If a selected hotel already has a run in progress, the request is rejected with 409.",
        "operationId": "generateText",
        "tags": [
          "Content Enrichment API/Text Generation"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Project-ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GenerateTextRequest"
              },
              "examples": {
                "byHotelIDs": {
                  "summary": "Regenerate all active templates for two hotels in all template locales",
                  "value": {
                    "HotelIDs": [
                      "0192fb17-5dc6-7abc-8def-123456789abc",
                      "0192fb18-6ed7-7abc-8def-223456789abc"
                    ]
                  }
                },
                "scopedRun": {
                  "summary": "Regenerate only the Summary template, two locales, full regeneration",
                  "value": {
                    "HotelIDs": [
                      "0192fb17-5dc6-7abc-8def-123456789abc"
                    ],
                    "TemplateKeys": [
                      "Summary"
                    ],
                    "Locales": [
                      "en-US",
                      "de-DE"
                    ],
                    "RegenMode": "full"
                  }
                },
                "byTag": {
                  "summary": "Fill missing texts for every project hotel carrying a tag",
                  "value": {
                    "TagIDs": [
                      "0192fb40-7aa1-7abc-8def-aabbccddeeff"
                    ],
                    "RegenMode": "fill_missing"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Text-generation run queued successfully. The run is processed asynchronously; poll getTextGenerationStatus with the returned run ID.",
            "headers": {
              "X-Trace-ID": {
                "$ref": "#/components/headers/X-Trace-ID"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GenerateTextResponse"
                },
                "examples": {
                  "byHotelIDs": {
                    "summary": "A freshly queued run for two hotels",
                    "value": {
                      "Data": {
                        "ID": "0192fb50-8bb2-7abc-8def-112233445566",
                        "Status": "queued",
                        "Progress": {
                          "Total": 2,
                          "Generated": 0,
                          "Failed": 0,
                          "Skipped": 0
                        },
                        "CreatedAt": "2026-06-26T09:15:00Z",
                        "UpdatedAt": "2026-06-26T09:15:00Z"
                      }
                    }
                  },
                  "scopedRun": {
                    "summary": "A freshly queued scoped run for one hotel",
                    "value": {
                      "Data": {
                        "ID": "0192fb51-9cc3-7abc-8def-2233445566aa",
                        "Status": "queued",
                        "Progress": {
                          "Total": 1,
                          "Generated": 0,
                          "Failed": 0,
                          "Skipped": 0
                        },
                        "CreatedAt": "2026-06-26T09:20:00Z",
                        "UpdatedAt": "2026-06-26T09:20:00Z"
                      }
                    }
                  },
                  "byTag": {
                    "summary": "A freshly queued run resolved from a tag",
                    "value": {
                      "Data": {
                        "ID": "0192fb52-add4-7abc-8def-3344556677bb",
                        "Status": "queued",
                        "Progress": {
                          "Total": 5,
                          "Generated": 0,
                          "Failed": 0,
                          "Skipped": 0
                        },
                        "CreatedAt": "2026-06-26T09:25:00Z",
                        "UpdatedAt": "2026-06-26T09:25:00Z"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/generateText_BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/generateText_Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/generateText_Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/generateText_NotFound"
          },
          "409": {
            "$ref": "#/components/responses/generateText_Conflict"
          },
          "429": {
            "$ref": "#/components/responses/generateText_TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/generateText_InternalServerError"
          }
        }
      }
    },
    "/v2/project/content/getContentSettings": {
      "post": {
        "summary": "Get content settings",
        "description": "Return the calling project's enabled output locales and default locale. When the project has no content settings configured, the response carries an empty locales list and an empty default locale.\n\nThe project is taken from the request scope; the request body carries no parameters.",
        "operationId": "getContentSettings",
        "tags": [
          "Content Enrichment API/Settings"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Project-ID"
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GetContentSettingsRequest"
              },
              "examples": {
                "noBody": {
                  "summary": "No request parameters are required",
                  "value": {}
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Content settings retrieved successfully.",
            "headers": {
              "X-Trace-ID": {
                "$ref": "#/components/headers/X-Trace-ID"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetContentSettingsResponse"
                },
                "examples": {
                  "configured": {
                    "summary": "A project with configured locales",
                    "value": {
                      "Data": {
                        "Locales": [
                          "en-US",
                          "de-DE",
                          "fr-FR"
                        ],
                        "DefaultLocale": "en-US"
                      }
                    }
                  },
                  "unconfigured": {
                    "summary": "A project with no content settings configured",
                    "value": {
                      "Data": {
                        "Locales": [],
                        "DefaultLocale": ""
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/getContentSettings_BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/getContentSettings_Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/getContentSettings_Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/getContentSettings_NotFound"
          },
          "429": {
            "$ref": "#/components/responses/getContentSettings_TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/getContentSettings_InternalServerError"
          }
        }
      }
    },
    "/v2/project/content/getEnrichedHotel": {
      "post": {
        "summary": "Get enriched hotel",
        "description": "Retrieve one fully enriched hotel with its rooms, images, points of interest, factual attributes, check-in and check-out times and per-locale generated texts.\n\nThe response is returned synchronously. Resolve the hotel with exactly one selector; each returns the same hotel.\n\n- `HotelID` is the hotel UUID, `GlobalHotelID` the cross-tenant identifier, `ExternalHotelID` a map of your own identifiers.\n- `ExternalHotelID` sub-keys are `productid`, `giata` and `peakworkgoalid`; several are AND-combined, so a conflict returns 404.\n- No selector, more than one, an unsupported sub-key, a non-numeric or non-positive `giata` or `peakworkgoalid`, or a `giata` above 2147483647 returns 400.\n- The hotel must be in your project's content set; an unknown or out-of-scope hotel returns 404.\n- 429 means the rate limit was hit; wait `Retry-After` seconds.",
        "operationId": "getEnrichedHotel",
        "tags": [
          "Content Enrichment API/Enrichment"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Project-ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GetEnrichedHotelRequest"
              },
              "examples": {
                "byHotelID": {
                  "summary": "Resolve by hotel UUID",
                  "value": {
                    "HotelID": "0192fb17-5dc6-7abc-8def-123456789abc"
                  }
                },
                "byGlobalHotelID": {
                  "summary": "Resolve by global hotel ID",
                  "value": {
                    "GlobalHotelID": "ES-MALLR-K7MP2"
                  }
                },
                "byProductID": {
                  "summary": "Resolve by the project's own product ID",
                  "value": {
                    "ExternalHotelID": {
                      "productid": "HTL-MAJ-4711"
                    }
                  }
                },
                "byProductIDAndGiata": {
                  "summary": "Resolve by product ID and GIATA together (both must match the same hotel)",
                  "value": {
                    "ExternalHotelID": {
                      "productid": "HTL-MAJ-4711",
                      "giata": "668370"
                    }
                  }
                },
                "byPeakworkGoalID": {
                  "summary": "Resolve by the hotel's Peakwork Goal ID",
                  "value": {
                    "ExternalHotelID": {
                      "peakworkgoalid": "864521"
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Enriched hotel retrieved successfully.",
            "headers": {
              "X-Trace-ID": {
                "$ref": "#/components/headers/X-Trace-ID"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetEnrichedHotelResponse"
                },
                "examples": {
                  "byHotelID": {
                    "$ref": "#/components/examples/EnrichedHotelResult"
                  },
                  "byGlobalHotelID": {
                    "$ref": "#/components/examples/EnrichedHotelResult"
                  },
                  "byProductID": {
                    "$ref": "#/components/examples/EnrichedHotelResult"
                  },
                  "byProductIDAndGiata": {
                    "$ref": "#/components/examples/EnrichedHotelResult"
                  },
                  "byPeakworkGoalID": {
                    "$ref": "#/components/examples/EnrichedHotelResult"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/getEnrichedHotel_BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/getEnrichedHotel_Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/getEnrichedHotel_Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/getEnrichedHotel_NotFound"
          },
          "429": {
            "$ref": "#/components/responses/getEnrichedHotel_TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/getEnrichedHotel_InternalServerError"
          }
        }
      }
    },
    "/v2/project/content/getTextGenerationStatus": {
      "post": {
        "summary": "Get text generation status",
        "description": "Retrieve the status and progress of a text-generation run by its UUID. Use this to poll the asynchronous run started by generateText until its Status becomes 'complete' or 'failed'. A run that does not belong to the calling project returns 404.",
        "operationId": "getTextGenerationStatus",
        "tags": [
          "Content Enrichment API/Text Generation"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Project-ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GetTextGenerationStatusRequest"
              },
              "examples": {
                "processing": {
                  "summary": "Poll a run by its UUID (still in progress)",
                  "value": {
                    "RunID": "0192fb50-8bb2-7abc-8def-112233445566"
                  }
                },
                "complete": {
                  "summary": "Poll a run by its UUID (finished)",
                  "value": {
                    "RunID": "0192fb50-8bb2-7abc-8def-112233445566"
                  }
                },
                "failed": {
                  "summary": "Poll a run by its UUID (failed)",
                  "value": {
                    "RunID": "0192fb50-8bb2-7abc-8def-112233445566"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Text-generation run status retrieved successfully.",
            "headers": {
              "X-Trace-ID": {
                "$ref": "#/components/headers/X-Trace-ID"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetTextGenerationStatusResponse"
                },
                "examples": {
                  "processing": {
                    "summary": "A run still in progress",
                    "value": {
                      "Data": {
                        "ID": "0192fb50-8bb2-7abc-8def-112233445566",
                        "Status": "processing",
                        "Progress": {
                          "Total": 5,
                          "Generated": 2,
                          "Failed": 0,
                          "Skipped": 0
                        },
                        "StartedAt": "2026-06-26T09:15:05Z",
                        "CreatedAt": "2026-06-26T09:15:00Z",
                        "UpdatedAt": "2026-06-26T09:16:10Z"
                      }
                    }
                  },
                  "complete": {
                    "summary": "A finished run",
                    "value": {
                      "Data": {
                        "ID": "0192fb50-8bb2-7abc-8def-112233445566",
                        "Status": "complete",
                        "Progress": {
                          "Total": 5,
                          "Generated": 5,
                          "Failed": 0,
                          "Skipped": 0
                        },
                        "StartedAt": "2026-06-26T09:15:05Z",
                        "CompletedAt": "2026-06-26T09:18:42Z",
                        "CreatedAt": "2026-06-26T09:15:00Z",
                        "UpdatedAt": "2026-06-26T09:18:42Z"
                      }
                    }
                  },
                  "failed": {
                    "summary": "A failed run",
                    "value": {
                      "Data": {
                        "ID": "0192fb50-8bb2-7abc-8def-112233445566",
                        "Status": "failed",
                        "Progress": {
                          "Total": 5,
                          "Generated": 1,
                          "Failed": 4,
                          "Skipped": 0
                        },
                        "ErrorMessage": "Text generation failed for one or more hotels",
                        "StartedAt": "2026-06-26T09:15:05Z",
                        "CompletedAt": "2026-06-26T09:16:20Z",
                        "CreatedAt": "2026-06-26T09:15:00Z",
                        "UpdatedAt": "2026-06-26T09:16:20Z"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/getTextGenerationStatus_BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/getTextGenerationStatus_Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/getTextGenerationStatus_Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/getTextGenerationStatus_NotFound"
          },
          "429": {
            "$ref": "#/components/responses/getTextGenerationStatus_TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/getTextGenerationStatus_InternalServerError"
          }
        }
      }
    },
    "/v2/project/content/listApprovalImageUploads": {
      "post": {
        "summary": "List approval image uploads",
        "description": "List one member hotel's photo uploads in every state but withdrawn (an upload the hotel undid), newest first, at most 200. Each upload carries its photo and its `ID`, the id of its feedback item, so a client can show the photo beside the item that `listHotelFeedback` returns. Pass the `ID` of a `pending` upload as `FeedbackID` to acceptApprovalImageUpload or rejectApprovalImageUpload.",
        "operationId": "listApprovalImageUploads",
        "tags": [
          "Content Enrichment API/Approval Links"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ListApprovalImageUploadsRequest"
              },
              "examples": {
                "listUploads": {
                  "summary": "List one hotel's photo uploads",
                  "value": {
                    "HotelID": "019d9c2e-0ef8-7458-b0fa-8bed7182eb30"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The hotel's uploads, newest first. `Uploads` is always an array, empty when there are none.",
            "headers": {
              "X-Trace-ID": {
                "$ref": "#/components/headers/X-Trace-ID"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListApprovalImageUploadsResponse"
                },
                "examples": {
                  "listUploads": {
                    "summary": "One pending and one accepted upload",
                    "value": {
                      "Data": {
                        "Uploads": [
                          {
                            "ID": "01a0f1c9-3e8a-7c12-b4d5-8e9f0a1b2c3d",
                            "HotelID": "019d9c2e-0ef8-7458-b0fa-8bed7182eb30",
                            "URL": "https://ucarecdn.com/8f14e45f-ceea-467a-9575-7d3b1c2a9e10/",
                            "Width": 1600,
                            "Height": 1200,
                            "FileSize": 0,
                            "Format": "",
                            "Status": "pending",
                            "CreatedAt": "2026-10-12T09:14:03.512874Z"
                          },
                          {
                            "ID": "01a0e7b4-52c1-7f6d-8a3e-0b9c4d2e1f70",
                            "HotelID": "019d9c2e-0ef8-7458-b0fa-8bed7182eb30",
                            "URL": "https://ucarecdn.com/3c59dc04-8e4a-4f7c-9c1d-6a2b5e8f0d31/",
                            "Width": 1600,
                            "Height": 1200,
                            "FileSize": 0,
                            "Format": "",
                            "Status": "accepted",
                            "CreatedAt": "2026-10-11T16:40:12.305918Z",
                            "ReviewedAt": "2026-10-11T17:05:44.118203Z"
                          }
                        ]
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/listApprovalImageUploads_BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/listApprovalImageUploads_Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/listApprovalImageUploads_NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/listApprovalImageUploads_InternalServerError"
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Project-ID"
          }
        ]
      }
    },
    "/v2/project/content/listApprovals": {
      "post": {
        "summary": "List approval links",
        "description": "List the calling project's approval links with their status, approver and last-opened time — the read behind an approval column in a hotel list or an approval panel on a hotel page. Pass `HotelIDs` to restrict the list to specific hotels, or omit it to page through every link of the project. Results are ordered by creation time then hotel id. Hotel ids that are not live members of the project are skipped and echoed in `NotInProjectIDs`. A link that was revoked before its hotel ever approved is excluded, from `Data` and from `Pagination.Total` alike; a link revoked after the hotel approved stays listed, carrying `RevokedAt` and no `Token`.",
        "operationId": "listApprovals",
        "tags": [
          "Content Enrichment API/Approval Links"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ListApprovalsRequest"
              },
              "examples": {
                "allLinks": {
                  "summary": "Every link of the project, first page",
                  "value": {
                    "Limit": 100,
                    "Offset": 0
                  }
                },
                "byHotelIDs": {
                  "summary": "Specific hotels, one of them not in the project",
                  "value": {
                    "HotelIDs": [
                      "019d9c2e-0ef8-7458-b0fa-8bed7182eb30",
                      "019d9c23-1238-7334-bf02-4c45c50e033a",
                      "019e4afb-e973-764c-9bb1-a4c66175e08b"
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The page of approval links.",
            "headers": {
              "X-Trace-ID": {
                "$ref": "#/components/headers/X-Trace-ID"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListApprovalsResponse"
                },
                "examples": {
                  "allLinks": {
                    "summary": "Every link of the project, including one revoked after its hotel approved",
                    "value": {
                      "Data": [
                        {
                          "HotelID": "019d9c23-1238-7334-bf02-4c45c50e033a",
                          "HotelName": "JAZ Makadina",
                          "GiataID": 16706,
                          "MasterCode": "HRGD0238",
                          "TokenPreview": "QxIpAvQh...",
                          "Status": "waiting_for_hotel",
                          "Created": false,
                          "CreatedBy": "editor@example.com",
                          "CreatedAt": "2026-08-25T18:19:17.522006Z",
                          "UpdatedAt": "2026-08-25T18:19:17.522006Z"
                        },
                        {
                          "HotelID": "019d9c2e-0ef8-7458-b0fa-8bed7182eb30",
                          "HotelName": "Sotavento Beach Club",
                          "GiataID": 5721,
                          "MasterCode": "FUED0009",
                          "TokenPreview": "xPBOjXHo...",
                          "Status": "approved",
                          "ApprovedAt": "2026-08-25T18:19:18.860882Z",
                          "ApprovedTextGeneratedAt": "2026-08-19T14:14:57.674681Z",
                          "ApprovedBy": {
                            "Name": "Ayşe Yılmaz",
                            "Email": "ayse@sotavento.example",
                            "Phone": "+34 928 000 000"
                          },
                          "LastOpenedAt": "2026-08-25T18:19:18.966928Z",
                          "Created": false,
                          "CreatedBy": "editor@example.com",
                          "CreatedAt": "2026-08-25T18:19:17.522006Z",
                          "UpdatedAt": "2026-08-25T18:19:18.860882Z"
                        },
                        {
                          "HotelID": "019d9c31-77a4-7c19-9d51-2f3b8ac41e77",
                          "HotelName": "Rixos Premium Belek",
                          "GiataID": 32118,
                          "MasterCode": "AYTD0114",
                          "TokenPreview": "Lm2VrXe7...",
                          "Status": "approved",
                          "ApprovedAt": "2026-08-25T18:19:19.104553Z",
                          "ApprovedTextGeneratedAt": "2026-08-19T14:14:57.674681Z",
                          "ApprovedBy": {
                            "Name": "Mehmet Demir",
                            "Email": "mehmet@rixos.example",
                            "Phone": "+90 242 000 00 00"
                          },
                          "LastOpenedAt": "2026-08-25T18:19:19.010441Z",
                          "RevokedAt": "2026-08-25T18:19:19.602402Z",
                          "Created": false,
                          "CreatedBy": "editor@example.com",
                          "CreatedAt": "2026-08-25T18:19:17.884219Z",
                          "UpdatedAt": "2026-08-25T18:19:19.602402Z"
                        }
                      ],
                      "Pagination": {
                        "Total": 3,
                        "Limit": 100,
                        "Offset": 0
                      }
                    }
                  },
                  "byHotelIDs": {
                    "summary": "Two links, the non-member id echoed back",
                    "value": {
                      "Data": [
                        {
                          "HotelID": "019d9c23-1238-7334-bf02-4c45c50e033a",
                          "HotelName": "JAZ Makadina",
                          "GiataID": 16706,
                          "MasterCode": "HRGD0238",
                          "TokenPreview": "QxIpAvQh...",
                          "Status": "waiting_for_hotel",
                          "Created": false,
                          "CreatedBy": "editor@example.com",
                          "CreatedAt": "2026-08-25T18:19:17.522006Z",
                          "UpdatedAt": "2026-08-25T18:19:17.522006Z"
                        },
                        {
                          "HotelID": "019d9c2e-0ef8-7458-b0fa-8bed7182eb30",
                          "HotelName": "Sotavento Beach Club",
                          "GiataID": 5721,
                          "MasterCode": "FUED0009",
                          "TokenPreview": "xPBOjXHo...",
                          "Status": "approved",
                          "ApprovedAt": "2026-08-25T18:19:18.860882Z",
                          "ApprovedTextGeneratedAt": "2026-08-19T14:14:57.674681Z",
                          "ApprovedBy": {
                            "Name": "Ayşe Yılmaz",
                            "Email": "ayse@sotavento.example",
                            "Phone": "+34 928 000 000"
                          },
                          "LastOpenedAt": "2026-08-25T18:19:18.966928Z",
                          "Created": false,
                          "CreatedBy": "editor@example.com",
                          "CreatedAt": "2026-08-25T18:19:17.522006Z",
                          "UpdatedAt": "2026-08-25T18:19:18.860882Z"
                        }
                      ],
                      "Pagination": {
                        "Total": 2,
                        "Limit": 100,
                        "Offset": 0
                      },
                      "NotInProjectIDs": [
                        "019e4afb-e973-764c-9bb1-a4c66175e08b"
                      ]
                    }
                  },
                  "projectTokenCaller": {
                    "summary": "Same call with a proj_ project token — contact PII omitted: ApprovedBy carries Name only and CreatedBy is absent",
                    "value": {
                      "Data": [
                        {
                          "HotelID": "019d9c23-1238-7334-bf02-4c45c50e033a",
                          "HotelName": "JAZ Makadina",
                          "GiataID": 16706,
                          "MasterCode": "HRGD0238",
                          "TokenPreview": "QxIpAvQh...",
                          "Status": "waiting_for_hotel",
                          "Created": false,
                          "CreatedAt": "2026-08-25T18:19:17.522006Z",
                          "UpdatedAt": "2026-08-25T18:19:17.522006Z"
                        },
                        {
                          "HotelID": "019d9c2e-0ef8-7458-b0fa-8bed7182eb30",
                          "HotelName": "Sotavento Beach Club",
                          "GiataID": 5721,
                          "MasterCode": "FUED0009",
                          "TokenPreview": "xPBOjXHo...",
                          "Status": "approved",
                          "ApprovedAt": "2026-08-25T18:19:18.860882Z",
                          "ApprovedTextGeneratedAt": "2026-08-19T14:14:57.674681Z",
                          "ApprovedBy": {
                            "Name": "Ayşe Yılmaz"
                          },
                          "LastOpenedAt": "2026-08-25T18:19:18.966928Z",
                          "Created": false,
                          "CreatedAt": "2026-08-25T18:19:17.522006Z",
                          "UpdatedAt": "2026-08-25T18:19:18.860882Z"
                        }
                      ],
                      "Pagination": {
                        "Total": 2,
                        "Limit": 100,
                        "Offset": 0
                      }
                    },
                    "description": "Identical request, answered for a caller presenting a `proj_` project token instead of a `user_` token. `ApprovedBy.Email`, `ApprovedBy.Phone` and `CreatedBy` are contact PII and are omitted entirely (the keys are absent, not empty strings). Everything else is unchanged."
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/listApprovals_BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/listApprovals_Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/listApprovals_NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/listApprovals_InternalServerError"
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Project-ID"
          }
        ]
      }
    },
    "/v2/project/content/listEnrichedHotelSummaries": {
      "post": {
        "summary": "List enriched hotel summaries",
        "description": "Return a paginated roster of the calling project's hotels, built and returned synchronously. Only hotels belonging to your project are returned. Rows also carry up to five images, the Summary text per locale and the nearest beach and airport; no rooms, attributes or other texts.\n\n- `Limit` defaults to 50, or to 100 when `HotelIDs` is set, and is capped at 100.\n- Every filter is AND-ed with the others; `Pagination.Total` counts the hotels left after filtering.\n- `HotelIDs` and `ExternalHotelIDs` take up to 100 elements each; rows keep the default order, not the order of `HotelIDs`.\n- `Sort: 'feedback_activity'` and the `LastFeedbackAt` and `LastFeedbackReplyAt` fields need the `content.authoring:read` permission; without it the fields are omitted and the sort returns 403.\n- An unknown tag returns 404.",
        "operationId": "listEnrichedHotelSummaries",
        "tags": [
          "Content Enrichment API/Enrichment"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Project-ID"
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ListEnrichedHotelSummariesRequest"
              },
              "examples": {
                "firstPage": {
                  "summary": "First page with default page size",
                  "value": {
                    "Limit": 50,
                    "Offset": 0
                  }
                },
                "filtered": {
                  "summary": "Filter by country, active status, and a search term",
                  "value": {
                    "CountryCode": "ES",
                    "Status": "active",
                    "Search": "beach resort",
                    "Limit": 25,
                    "Offset": 0
                  }
                },
                "byTags": {
                  "summary": "Restrict to the project's hotels carrying all of these tags",
                  "value": {
                    "TagIDs": [
                      "0192fc01-1111-7abc-8def-aaaaaaaaaaaa",
                      "0192fc02-2222-7abc-8def-bbbbbbbbbbbb"
                    ],
                    "Limit": 50,
                    "Offset": 0
                  }
                },
                "byExternalHotelID": {
                  "summary": "Restrict to hotels matching either of two external-identity selectors",
                  "value": {
                    "ExternalHotelIDs": [
                      {
                        "productid": "HTL-MAJ-4711"
                      },
                      {
                        "giata": "7654321",
                        "peakworkgoalid": "864522"
                      }
                    ],
                    "Limit": 50,
                    "Offset": 0
                  }
                },
                "byHotelIDs": {
                  "summary": "Fetch named hotels by id in one request",
                  "value": {
                    "HotelIDs": [
                      "0192fb17-5dc6-7abc-8def-123456789abc",
                      "0192fb18-6ed7-7abc-8def-223456789abc",
                      "0192fb19-7fe8-7abc-8def-323456789abc"
                    ]
                  }
                },
                "byFeedbackActivity": {
                  "summary": "The most recent feedback activity first",
                  "value": {
                    "Sort": "feedback_activity",
                    "Limit": 50,
                    "Offset": 0
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Project hotel roster retrieved successfully.",
            "headers": {
              "X-Trace-ID": {
                "$ref": "#/components/headers/X-Trace-ID"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListEnrichedHotelSummariesResponse"
                },
                "examples": {
                  "firstPage": {
                    "summary": "A page of enriched hotel summaries",
                    "value": {
                      "Data": [
                        {
                          "ID": "0192fb17-5dc6-7abc-8def-123456789abc",
                          "Name": "Bahia Azul Beach Resort",
                          "ExternalHotelIDs": {
                            "ProductID": "HTL-MAJ-4711",
                            "Giata": "668370"
                          },
                          "GlobalHotelID": "ES-MALLR-K7MP2",
                          "Stars": 4,
                          "StarsMap": {
                            "default": {
                              "Stars": 4,
                              "Superior": false,
                              "Garni": false
                            }
                          },
                          "CountryCode": "ES",
                          "City": "Palma",
                          "CityNames": {
                            "en-US": "Palma",
                            "de-DE": "Palma"
                          },
                          "Status": "active",
                          "TextEnrichmentStatus": "enriched",
                          "TextStatus": "generated",
                          "LastEnrichedAt": "2026-04-12T09:15:00Z",
                          "FullyEnrichedAt": "2026-04-12T09:15:00Z",
                          "Latitude": 39.5696,
                          "Longitude": 2.6502,
                          "Images": [
                            {
                              "URL": "https://cdn.ygo.ai/hotels/bahia-azul/exterior-pool.jpg",
                              "Width": 1600,
                              "Height": 1067,
                              "BlurHash": "LKO2?U%2Tw=w]~RBVZRi};RPxuwH"
                            },
                            {
                              "URL": "https://cdn.ygo.ai/hotels/bahia-azul/beach.jpg",
                              "Width": 1600,
                              "Height": 1067,
                              "BlurHash": "L6PZfSi_.AyE_3t7t7R**0o#DgR4"
                            },
                            {
                              "URL": "https://cdn.ygo.ai/hotels/bahia-azul/room-sea-view.jpg",
                              "Width": 1200,
                              "Height": 800,
                              "BlurHash": "LEHV6nWB2yk8pyo0adR*.7kCMdnj"
                            }
                          ],
                          "GeneratedTexts": {
                            "de-DE": {
                              "Summary": {
                                "Text": "Das Bahia Azul Beach Resort liegt an einem ruhigen Abschnitt der Bucht von Palma und verbindet direkten Strandzugang mit hellen, modernen Zimmern und einem Dachpool mit Meerblick.",
                                "GeneratedAt": "2026-04-12T09:15:00Z",
                                "Compliance": {
                                  "AIGenerated": true
                                }
                              }
                            },
                            "en-US": {
                              "Summary": {
                                "Text": "Set on a quiet stretch of the Bay of Palma, Bahia Azul Beach Resort pairs direct beach access with bright, contemporary rooms and a sea-view rooftop pool.",
                                "GeneratedAt": "2026-04-12T09:15:00Z",
                                "Compliance": {
                                  "AIGenerated": true
                                }
                              }
                            }
                          },
                          "NearestPOIs": [
                            {
                              "Type": "beach",
                              "Distance": 0,
                              "Unit": "m"
                            },
                            {
                              "Type": "airport",
                              "Distance": 11.4,
                              "Unit": "km"
                            }
                          ],
                          "CreatedAt": "2026-03-01T08:00:00Z",
                          "UpdatedAt": "2026-04-12T09:15:00Z"
                        },
                        {
                          "ID": "0192fb18-6ed7-7abc-8def-223456789abc",
                          "Name": "Costa Verde City Hotel",
                          "ExternalHotelIDs": {
                            "ProductID": "ESVALEN0007",
                            "Giata": "7654321"
                          },
                          "Stars": 3,
                          "StarsMap": {
                            "default": {
                              "Stars": 3,
                              "Superior": false,
                              "Garni": false
                            }
                          },
                          "CountryCode": "ES",
                          "City": "Valencia",
                          "Status": "draft",
                          "TextEnrichmentStatus": "none",
                          "TextStatus": "none",
                          "CreatedAt": "2026-03-04T10:30:00Z",
                          "UpdatedAt": "2026-03-20T14:05:00Z"
                        }
                      ],
                      "Pagination": {
                        "Total": 128,
                        "Limit": 50,
                        "Offset": 0
                      }
                    }
                  },
                  "filtered": {
                    "summary": "A filtered page with a single match",
                    "value": {
                      "Data": [
                        {
                          "ID": "0192fb17-5dc6-7abc-8def-123456789abc",
                          "Name": "Bahia Azul Beach Resort",
                          "ExternalHotelIDs": {
                            "ProductID": "HTL-MAJ-4711",
                            "Giata": "668370"
                          },
                          "GlobalHotelID": "ES-MALLR-K7MP2",
                          "Stars": 4,
                          "StarsMap": {
                            "default": {
                              "Stars": 4,
                              "Superior": false,
                              "Garni": false
                            }
                          },
                          "CountryCode": "ES",
                          "City": "Palma",
                          "CityNames": {
                            "en-US": "Palma",
                            "de-DE": "Palma"
                          },
                          "Status": "active",
                          "TextEnrichmentStatus": "enriched",
                          "TextStatus": "generated",
                          "LastEnrichedAt": "2026-04-12T09:15:00Z",
                          "FullyEnrichedAt": "2026-04-12T09:15:00Z",
                          "Latitude": 39.5696,
                          "Longitude": 2.6502,
                          "CreatedAt": "2026-03-01T08:00:00Z",
                          "UpdatedAt": "2026-04-12T09:15:00Z"
                        }
                      ],
                      "Pagination": {
                        "Total": 1,
                        "Limit": 25,
                        "Offset": 0
                      }
                    }
                  },
                  "byTags": {
                    "summary": "A page narrowed to hotels carrying all requested tags",
                    "value": {
                      "Data": [
                        {
                          "ID": "0192fb17-5dc6-7abc-8def-123456789abc",
                          "Name": "Bahia Azul Beach Resort",
                          "ExternalHotelIDs": {
                            "ProductID": "HTL-MAJ-4711",
                            "Giata": "668370"
                          },
                          "GlobalHotelID": "ES-MALLR-K7MP2",
                          "Stars": 4,
                          "StarsMap": {
                            "default": {
                              "Stars": 4,
                              "Superior": false,
                              "Garni": false
                            }
                          },
                          "CountryCode": "ES",
                          "City": "Palma",
                          "CityNames": {
                            "en-US": "Palma",
                            "de-DE": "Palma"
                          },
                          "Status": "active",
                          "TextEnrichmentStatus": "enriched",
                          "TextStatus": "generated",
                          "LastEnrichedAt": "2026-04-12T09:15:00Z",
                          "FullyEnrichedAt": "2026-04-12T09:15:00Z",
                          "Latitude": 39.5696,
                          "Longitude": 2.6502,
                          "Tags": [
                            {
                              "ID": "0192fc01-1111-7abc-8def-aaaaaaaaaaaa",
                              "Name": "Summer Campaign",
                              "Description": "Hotels in the 2026 summer campaign"
                            },
                            {
                              "ID": "0192fc02-2222-7abc-8def-bbbbbbbbbbbb",
                              "Name": "Beachfront"
                            }
                          ],
                          "CreatedAt": "2026-03-01T08:00:00Z",
                          "UpdatedAt": "2026-04-12T09:15:00Z"
                        }
                      ],
                      "Pagination": {
                        "Total": 1,
                        "Limit": 50,
                        "Offset": 0
                      }
                    }
                  },
                  "byExternalHotelID": {
                    "summary": "A page narrowed to hotels matching the supplied external-identity selectors",
                    "value": {
                      "Data": [
                        {
                          "ID": "0192fb17-5dc6-7abc-8def-123456789abc",
                          "Name": "Bahia Azul Beach Resort",
                          "ExternalHotelIDs": {
                            "ProductID": "HTL-MAJ-4711",
                            "Giata": "668370"
                          },
                          "GlobalHotelID": "ES-MALLR-K7MP2",
                          "Stars": 4,
                          "StarsMap": {
                            "default": {
                              "Stars": 4,
                              "Superior": false,
                              "Garni": false
                            }
                          },
                          "CountryCode": "ES",
                          "City": "Palma",
                          "CityNames": {
                            "en-US": "Palma",
                            "de-DE": "Palma"
                          },
                          "Status": "active",
                          "TextEnrichmentStatus": "enriched",
                          "TextStatus": "generated",
                          "LastEnrichedAt": "2026-04-12T09:15:00Z",
                          "FullyEnrichedAt": "2026-04-12T09:15:00Z",
                          "Latitude": 39.5696,
                          "Longitude": 2.6502,
                          "CreatedAt": "2026-03-01T08:00:00Z",
                          "UpdatedAt": "2026-04-12T09:15:00Z"
                        },
                        {
                          "ID": "0192fb18-6ed7-7abc-8def-223456789abc",
                          "Name": "Costa Verde City Hotel",
                          "ExternalHotelIDs": {
                            "ProductID": "ESVALEN0007",
                            "Giata": "7654321",
                            "PeakworkGoalID": "864522"
                          },
                          "Stars": 3,
                          "StarsMap": {
                            "default": {
                              "Stars": 3,
                              "Superior": false,
                              "Garni": false
                            }
                          },
                          "CountryCode": "ES",
                          "City": "Valencia",
                          "Status": "draft",
                          "TextEnrichmentStatus": "none",
                          "TextStatus": "none",
                          "CreatedAt": "2026-03-04T10:30:00Z",
                          "UpdatedAt": "2026-03-20T14:05:00Z"
                        }
                      ],
                      "Pagination": {
                        "Total": 2,
                        "Limit": 50,
                        "Offset": 0
                      }
                    }
                  },
                  "byHotelIDs": {
                    "summary": "The named hotels that belong to the project; the third id is not one of the project's hotels and is absent",
                    "value": {
                      "Data": [
                        {
                          "ID": "0192fb17-5dc6-7abc-8def-123456789abc",
                          "Name": "Bahia Azul Beach Resort",
                          "ExternalHotelIDs": {
                            "ProductID": "HTL-MAJ-4711",
                            "Giata": "668370"
                          },
                          "GlobalHotelID": "ES-MALLR-K7MP2",
                          "Stars": 4,
                          "StarsMap": {
                            "default": {
                              "Stars": 4,
                              "Superior": false,
                              "Garni": false
                            }
                          },
                          "CountryCode": "ES",
                          "City": "Palma",
                          "CityNames": {
                            "en-US": "Palma",
                            "de-DE": "Palma"
                          },
                          "Status": "active",
                          "TextEnrichmentStatus": "enriched",
                          "TextStatus": "generated",
                          "LastEnrichedAt": "2026-04-12T09:15:00Z",
                          "FullyEnrichedAt": "2026-04-12T09:15:00Z",
                          "Latitude": 39.5696,
                          "Longitude": 2.6502,
                          "CreatedAt": "2026-03-01T08:00:00Z",
                          "UpdatedAt": "2026-04-12T09:15:00Z"
                        },
                        {
                          "ID": "0192fb18-6ed7-7abc-8def-223456789abc",
                          "Name": "Costa Verde City Hotel",
                          "ExternalHotelIDs": {
                            "ProductID": "ESVALEN0007",
                            "Giata": "7654321"
                          },
                          "Stars": 3,
                          "StarsMap": {
                            "default": {
                              "Stars": 3,
                              "Superior": false,
                              "Garni": false
                            }
                          },
                          "CountryCode": "ES",
                          "City": "Valencia",
                          "Status": "draft",
                          "TextEnrichmentStatus": "none",
                          "TextStatus": "none",
                          "CreatedAt": "2026-03-04T10:30:00Z",
                          "UpdatedAt": "2026-03-20T14:05:00Z"
                        }
                      ],
                      "Pagination": {
                        "Total": 2,
                        "Limit": 100,
                        "Offset": 0
                      }
                    }
                  },
                  "byFeedbackActivity": {
                    "summary": "Sorted by feedback activity: the first hotel's newest event is a reply on an older comment, the second's a new comment, the third has no feedback",
                    "value": {
                      "Data": [
                        {
                          "ID": "0192fb18-6ed7-7abc-8def-223456789abc",
                          "Name": "Costa Verde City Hotel",
                          "ExternalHotelIDs": {
                            "ProductID": "ESVALEN0007",
                            "Giata": "7654321"
                          },
                          "Stars": 3,
                          "StarsMap": {
                            "default": {
                              "Stars": 3,
                              "Superior": false,
                              "Garni": false
                            }
                          },
                          "CountryCode": "ES",
                          "City": "Valencia",
                          "Status": "draft",
                          "TextEnrichmentStatus": "none",
                          "TextStatus": "none",
                          "LastFeedbackAt": "2026-09-30T15:02:47.120554Z",
                          "LastFeedbackReplyAt": "2026-10-07T10:18:05.903311Z",
                          "CreatedAt": "2026-03-04T10:30:00Z",
                          "UpdatedAt": "2026-03-20T14:05:00Z"
                        },
                        {
                          "ID": "0192fb17-5dc6-7abc-8def-123456789abc",
                          "Name": "Bahia Azul Beach Resort",
                          "ExternalHotelIDs": {
                            "ProductID": "HTL-MAJ-4711",
                            "Giata": "668370"
                          },
                          "GlobalHotelID": "ES-MALLR-K7MP2",
                          "Stars": 4,
                          "StarsMap": {
                            "default": {
                              "Stars": 4,
                              "Superior": false,
                              "Garni": false
                            }
                          },
                          "CountryCode": "ES",
                          "City": "Palma",
                          "Status": "active",
                          "TextEnrichmentStatus": "enriched",
                          "TextStatus": "generated",
                          "LastEnrichedAt": "2026-04-12T09:15:00Z",
                          "FullyEnrichedAt": "2026-04-12T09:15:00Z",
                          "Latitude": 39.5696,
                          "Longitude": 2.6502,
                          "LastFeedbackAt": "2026-10-07T08:41:12.483917Z",
                          "CreatedAt": "2026-03-01T08:00:00Z",
                          "UpdatedAt": "2026-04-12T09:15:00Z"
                        },
                        {
                          "ID": "0192fb19-7fe8-7abc-8def-323456789abc",
                          "Name": "Sierra Alta Mountain Lodge",
                          "ExternalHotelIDs": {
                            "ProductID": "ESGRANA0042",
                            "Giata": "8812345"
                          },
                          "Stars": 4,
                          "StarsMap": {
                            "default": {
                              "Stars": 4,
                              "Superior": false,
                              "Garni": false
                            }
                          },
                          "CountryCode": "ES",
                          "City": "Granada",
                          "Status": "active",
                          "TextEnrichmentStatus": "enriched",
                          "TextStatus": "generated",
                          "LastEnrichedAt": "2026-04-02T07:40:00Z",
                          "Latitude": 37.1773,
                          "Longitude": -3.5986,
                          "CreatedAt": "2026-03-05T11:20:00Z",
                          "UpdatedAt": "2026-04-02T07:40:00Z"
                        }
                      ],
                      "Pagination": {
                        "Total": 3,
                        "Limit": 50,
                        "Offset": 0
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/listEnrichedHotelSummaries_BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/listEnrichedHotelSummaries_Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/listEnrichedHotelSummaries_Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/listEnrichedHotelSummaries_NotFound"
          },
          "429": {
            "$ref": "#/components/responses/listEnrichedHotelSummaries_TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/listEnrichedHotelSummaries_InternalServerError"
          }
        }
      }
    },
    "/v2/project/content/listEnrichedHotels": {
      "post": {
        "summary": "List enriched hotels",
        "description": "Return a paginated array of full enriched hotels for the calling project.\n\nEach row is the same full hotel `getEnrichedHotel` returns, built and returned synchronously. Because every row is a full build the page is hard-capped at 50 hotels.\n\n- `Limit` above 50 is clamped to 50; for a lean roster use `listEnrichedHotelSummaries`.\n- Filters: country, status, full-enrichment flag, text-enrichment state, code kind and free-text search.\n- `TagIDs` and `TagName` narrow to hotels carrying all named tags; an unknown tag returns 404.\n- `ExternalHotelIDs` holds up to 50 selectors, OR-ed with each other and AND-ed with every other filter.\n- Only hotels belonging to your project are returned.\n- 429 means the rate limit was hit; wait `Retry-After` seconds.",
        "operationId": "listEnrichedHotels",
        "tags": [
          "Content Enrichment API/Enrichment"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Project-ID"
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ListEnrichedHotelsRequest"
              },
              "examples": {
                "firstPage": {
                  "summary": "First page with default page size",
                  "value": {
                    "Limit": 50,
                    "Offset": 0
                  }
                },
                "filtered": {
                  "summary": "Filter by country, active status, and a search term",
                  "value": {
                    "CountryCode": "ES",
                    "Status": "active",
                    "Search": "beach resort",
                    "Limit": 25,
                    "Offset": 0
                  }
                },
                "byTags": {
                  "summary": "Restrict to hotels carrying all of these project tags",
                  "value": {
                    "TagIDs": [
                      "0192fc01-1111-7abc-8def-aaaaaaaaaaaa",
                      "0192fc02-2222-7abc-8def-bbbbbbbbbbbb"
                    ],
                    "Limit": 50,
                    "Offset": 0
                  }
                },
                "byTagName": {
                  "summary": "Restrict to hotels carrying a single tag by name",
                  "value": {
                    "TagName": "Summer Campaign",
                    "Limit": 50,
                    "Offset": 0
                  }
                },
                "byExternalHotelID": {
                  "summary": "Restrict to hotels matching either of two external-identity selectors",
                  "value": {
                    "ExternalHotelIDs": [
                      {
                        "productid": "HTL-MAJ-4711"
                      },
                      {
                        "giata": "7654321",
                        "peakworkgoalid": "864522"
                      }
                    ],
                    "Limit": 50,
                    "Offset": 0
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Enriched hotels retrieved successfully.",
            "headers": {
              "X-Trace-ID": {
                "$ref": "#/components/headers/X-Trace-ID"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListEnrichedHotelsResponse"
                },
                "examples": {
                  "firstPage": {
                    "summary": "A page of full enriched hotels",
                    "value": {
                      "Data": [
                        {
                          "ID": "0192fb17-5dc6-7abc-8def-123456789abc",
                          "Name": "Bahia Azul Beach Resort",
                          "Names": {
                            "en-US": "Bahia Azul Beach Resort",
                            "de-DE": "Bahia Azul Strandresort"
                          },
                          "ExternalHotelIDs": {
                            "ProductID": "HTL-MAJ-4711",
                            "Giata": "668370"
                          },
                          "GlobalHotelID": "ES-MALLR-K7MP2",
                          "Stars": 4,
                          "StarsMap": {
                            "default": {
                              "Stars": 4,
                              "Superior": false,
                              "Garni": false
                            }
                          },
                          "AccommodationType": "resort",
                          "Chain": "Meliá Hotels International",
                          "Brand": "Sol by Meliá",
                          "Location": {
                            "Latitude": 39.5696,
                            "Longitude": 2.6502,
                            "CountryCode": "ES",
                            "Address": {
                              "Street": "Carrer de la Mar 12",
                              "City": "Palma",
                              "CityNames": {
                                "en-US": "Palma",
                                "de-DE": "Palma"
                              },
                              "State": "Illes Balears",
                              "PostalCode": "07015",
                              "Phone": "+34 971 000 000",
                              "Email": "info@bahia-azul.example"
                            }
                          },
                          "FactualAttributes": [
                            {
                              "Key": "wifi",
                              "Type": "factual",
                              "Name": {
                                "en-US": "Free WiFi",
                                "de-DE": "Kostenloses WLAN"
                              },
                              "Value": "true",
                              "ValueType": "boolean",
                              "ParentKey": "facilities_and_services",
                              "IsFree": true,
                              "GTCodes": [
                                "GT03-INTE",
                                "AT03-FRCH"
                              ]
                            }
                          ],
                          "POIs": [
                            {
                              "ID": "0192fb20-1aa2-7def-9abc-3344556677cc",
                              "Name": {
                                "en-US": "Es Portitxol",
                                "de-DE": "Es Portitxol"
                              },
                              "Type": "attraction",
                              "IsArea": true,
                              "InArea": true
                            },
                            {
                              "ID": "0192fb20-1aa2-7def-9abc-1122334455aa",
                              "Name": {
                                "en-US": "Palma Cathedral",
                                "de-DE": "Kathedrale von Palma"
                              },
                              "Type": "landmark",
                              "Distance": 3.2,
                              "Unit": "km",
                              "Latitude": 39.5675,
                              "Longitude": 2.6484
                            }
                          ],
                          "CheckIn": {
                            "From": "15:00"
                          },
                          "CheckOut": {
                            "Until": "11:00"
                          },
                          "GeneratedTexts": {
                            "en-US": {
                              "Summary": {
                                "Text": "Set on a quiet stretch of the Bay of Palma, Bahia Azul Beach Resort pairs direct beach access with bright, contemporary rooms and a sea-view rooftop pool.",
                                "Compliance": {
                                  "AIGenerated": true
                                }
                              }
                            }
                          },
                          "GuestRating": {
                            "ReviewScore": 93,
                            "SubScores": {
                              "Cleanliness": 96,
                              "Facilities": 93,
                              "Food": 91,
                              "Location": 91,
                              "Rooms": 95,
                              "Service": 96,
                              "Value": 90
                            },
                            "Texts": {
                              "en-US": {
                                "Summary": "Guests consistently describe their stay as a peaceful, relaxing retreat highlighted by exceptionally friendly and attentive staff. Rooms and grounds are praised for being spotless and comfortable, while the delicious breakfast and calm adults-only setting make it an ideal getaway.",
                                "Pros": [
                                  "Warm, attentive, and professional staff",
                                  "Spotless rooms and well-kept grounds",
                                  "Peaceful, child-free atmosphere",
                                  "Superb and varied breakfast spread",
                                  "Modern, spacious guest rooms"
                                ],
                                "Cons": [
                                  "Extra charges for some premium drinks and minibar",
                                  "Lunch and dinner buffets can feel repetitive to some"
                                ],
                                "GeneratedAt": "2026-11-05T18:10:57Z",
                                "Compliance": {
                                  "AIGenerated": true
                                }
                              }
                            }
                          },
                          "RenderLayouts": {
                            "Summary": "prose"
                          },
                          "Images": [
                            {
                              "ID": "0192fb20-1aa2-7def-9abc-1122334455aa",
                              "URL": "https://cdn.ygo.ai/hotels/bahia-azul/exterior-pool.jpg",
                              "Source": "photo",
                              "Category": "exterior",
                              "Features": [
                                "pool",
                                "sea_view"
                              ],
                              "Mood": [
                                "relaxing"
                              ],
                              "Tags": [
                                "rooftop",
                                "sunset"
                              ],
                              "AppealScore": 88,
                              "QualityScore": 91,
                              "AppealScoreVersion": "app-v4",
                              "QualityScoreVersion": "qs-v4",
                              "Width": 1600,
                              "Height": 1067,
                              "Format": "jpeg",
                              "FileSize": 412000,
                              "DominantColor": "#2E6F95",
                              "BlurHash": "LKO2?U%2Tw=w]~RBVZRi};RPxuwH",
                              "FileMetadata": {
                                "CaptureDate": "2012-06-14",
                                "Copyright": "© 2012 Hotel Sol S.A."
                              },
                              "Descriptions": {
                                "en-US": "Rooftop infinity pool overlooking the Bay of Palma at sunset."
                              },
                              "Compliance": {
                                "AIGenerated": true
                              },
                              "Presence": [
                                {
                                  "Label": "person",
                                  "Confidence": 0.91
                                },
                                {
                                  "Label": "adult",
                                  "Confidence": 0.86
                                }
                              ],
                              "Safety": {
                                "Inappropriate": 0.02,
                                "OffTopic": null
                              },
                              "TextDetections": [
                                {
                                  "Content": "POOL BAR",
                                  "Label": "signage",
                                  "Confidence": 0.74
                                }
                              ],
                              "FeatureDetections": [
                                {
                                  "Label": "pool",
                                  "Confidence": 0.96
                                },
                                {
                                  "Label": "sea_view",
                                  "Confidence": 0.9
                                }
                              ]
                            }
                          ],
                          "Rooms": [
                            {
                              "ID": "0192fb30-2bb3-7abc-8def-99887766aabb",
                              "Name": {
                                "en-US": "Double Room Sea View",
                                "de-DE": "Doppelzimmer mit Meerblick"
                              },
                              "SizeSqm": 26,
                              "Beddings": [
                                [
                                  {
                                    "Type": "DOUBLE",
                                    "Quantity": 1,
                                    "Name": {
                                      "en-US": "double bed",
                                      "de-DE": "Doppelbett"
                                    }
                                  }
                                ],
                                [
                                  {
                                    "Type": "TWIN",
                                    "Quantity": 2,
                                    "Name": {
                                      "en-US": "twin beds",
                                      "de-DE": "Einzelbetten"
                                    }
                                  }
                                ]
                              ],
                              "FactualAttributes": [
                                {
                                  "Key": "air_conditioning",
                                  "Type": "factual",
                                  "Name": {
                                    "en-US": "Air Conditioning",
                                    "de-DE": "Klimaanlage"
                                  },
                                  "Value": "true",
                                  "ValueType": "boolean",
                                  "ParentKey": "room_facilities",
                                  "IsFree": true,
                                  "GTCodes": [
                                    "GT05-AICO",
                                    "AT05-FRCH"
                                  ]
                                }
                              ],
                              "RenderLayouts": {
                                "": "roomcards"
                              },
                              "ExternalRoomIDs": {
                                "ProductRoomIDs": [
                                  "11824",
                                  "11902"
                                ]
                              },
                              "Images": [],
                              "Status": "active",
                              "CreatedAt": "2026-03-01T08:00:00Z",
                              "UpdatedAt": "2026-04-10T12:30:00Z"
                            }
                          ],
                          "Tags": [
                            {
                              "ID": "0192fc01-1111-7abc-8def-aaaaaaaaaaaa",
                              "Name": "Summer Campaign"
                            }
                          ],
                          "Status": "active",
                          "TextStatus": "generated",
                          "CreatedAt": "2026-03-01T08:00:00Z",
                          "UpdatedAt": "2026-04-12T09:15:00Z"
                        }
                      ],
                      "Pagination": {
                        "Total": 128,
                        "Limit": 50,
                        "Offset": 0
                      }
                    }
                  },
                  "filtered": {
                    "summary": "A filtered page with a single match",
                    "value": {
                      "Data": [
                        {
                          "ID": "0192fb17-5dc6-7abc-8def-123456789abc",
                          "Name": "Bahia Azul Beach Resort",
                          "Names": {
                            "en-US": "Bahia Azul Beach Resort"
                          },
                          "ExternalHotelIDs": {
                            "ProductID": "HTL-MAJ-4711",
                            "Giata": "668370"
                          },
                          "GlobalHotelID": "ES-MALLR-K7MP2",
                          "Stars": 4,
                          "StarsMap": {
                            "default": {
                              "Stars": 4,
                              "Superior": false,
                              "Garni": false
                            }
                          },
                          "AccommodationType": "resort",
                          "Chain": "Meliá Hotels International",
                          "Brand": "Sol by Meliá",
                          "Location": {
                            "Latitude": 39.5696,
                            "Longitude": 2.6502,
                            "CountryCode": "ES",
                            "Address": {
                              "Street": "Carrer de la Mar 12",
                              "City": "Palma",
                              "State": "Illes Balears",
                              "PostalCode": "07015"
                            }
                          },
                          "FactualAttributes": [],
                          "POIs": [],
                          "GeneratedTexts": {
                            "en-US": {
                              "Summary": {
                                "Text": "A short walk from the old town, the hotel pairs a rooftop terrace with calm, light-filled rooms.",
                                "Compliance": {
                                  "AIGenerated": true
                                }
                              }
                            }
                          },
                          "GuestRating": {
                            "ReviewScore": 93,
                            "SubScores": {
                              "Cleanliness": 96,
                              "Facilities": 93,
                              "Food": 91,
                              "Location": 91,
                              "Rooms": 95,
                              "Service": 96,
                              "Value": 90
                            },
                            "Texts": {
                              "en-US": {
                                "Summary": "Guests consistently describe their stay as a peaceful, relaxing retreat highlighted by exceptionally friendly and attentive staff. Rooms and grounds are praised for being spotless and comfortable, while the delicious breakfast and calm adults-only setting make it an ideal getaway.",
                                "Pros": [
                                  "Warm, attentive, and professional staff",
                                  "Spotless rooms and well-kept grounds",
                                  "Peaceful, child-free atmosphere",
                                  "Superb and varied breakfast spread",
                                  "Modern, spacious guest rooms"
                                ],
                                "Cons": [
                                  "Extra charges for some premium drinks and minibar",
                                  "Lunch and dinner buffets can feel repetitive to some"
                                ],
                                "GeneratedAt": "2026-11-05T18:10:57Z",
                                "Compliance": {
                                  "AIGenerated": true
                                }
                              }
                            }
                          },
                          "Images": [],
                          "Rooms": [],
                          "Status": "active",
                          "TextStatus": "generated",
                          "CreatedAt": "2026-03-01T08:00:00Z",
                          "UpdatedAt": "2026-04-12T09:15:00Z"
                        }
                      ],
                      "Pagination": {
                        "Total": 1,
                        "Limit": 25,
                        "Offset": 0
                      }
                    }
                  },
                  "byTags": {
                    "summary": "A page narrowed to hotels carrying all requested tags",
                    "value": {
                      "Data": [
                        {
                          "ID": "0192fb17-5dc6-7abc-8def-123456789abc",
                          "Name": "Bahia Azul Beach Resort",
                          "Names": {
                            "en-US": "Bahia Azul Beach Resort"
                          },
                          "ExternalHotelIDs": {
                            "ProductID": "HTL-MAJ-4711",
                            "Giata": "668370"
                          },
                          "GlobalHotelID": "ES-MALLR-K7MP2",
                          "Stars": 4,
                          "StarsMap": {
                            "default": {
                              "Stars": 4,
                              "Superior": false,
                              "Garni": false
                            }
                          },
                          "AccommodationType": "resort",
                          "Chain": "Meliá Hotels International",
                          "Brand": "Sol by Meliá",
                          "Location": {
                            "Latitude": 39.5696,
                            "Longitude": 2.6502,
                            "CountryCode": "ES"
                          },
                          "FactualAttributes": [],
                          "POIs": [],
                          "GeneratedTexts": {
                            "en-US": {
                              "Summary": {
                                "Text": "Set back from the promenade, the hotel offers quiet rooms, a garden pool and a short walk to the beach.",
                                "Compliance": {
                                  "AIGenerated": true
                                }
                              }
                            }
                          },
                          "GuestRating": {
                            "ReviewScore": 93,
                            "SubScores": {
                              "Cleanliness": 96,
                              "Facilities": 93,
                              "Food": 91,
                              "Location": 91,
                              "Rooms": 95,
                              "Service": 96,
                              "Value": 90
                            },
                            "Texts": {
                              "en-US": {
                                "Summary": "Guests consistently describe their stay as a peaceful, relaxing retreat highlighted by exceptionally friendly and attentive staff. Rooms and grounds are praised for being spotless and comfortable, while the delicious breakfast and calm adults-only setting make it an ideal getaway.",
                                "Pros": [
                                  "Warm, attentive, and professional staff",
                                  "Spotless rooms and well-kept grounds",
                                  "Peaceful, child-free atmosphere",
                                  "Superb and varied breakfast spread",
                                  "Modern, spacious guest rooms"
                                ],
                                "Cons": [
                                  "Extra charges for some premium drinks and minibar",
                                  "Lunch and dinner buffets can feel repetitive to some"
                                ],
                                "GeneratedAt": "2026-11-05T18:10:57Z",
                                "Compliance": {
                                  "AIGenerated": true
                                }
                              }
                            }
                          },
                          "Images": [],
                          "Rooms": [],
                          "Tags": [
                            {
                              "ID": "0192fc01-1111-7abc-8def-aaaaaaaaaaaa",
                              "Name": "Summer Campaign"
                            },
                            {
                              "ID": "0192fc02-2222-7abc-8def-bbbbbbbbbbbb",
                              "Name": "Beachfront"
                            }
                          ],
                          "Status": "active",
                          "TextStatus": "generated",
                          "CreatedAt": "2026-03-01T08:00:00Z",
                          "UpdatedAt": "2026-04-12T09:15:00Z"
                        }
                      ],
                      "Pagination": {
                        "Total": 1,
                        "Limit": 50,
                        "Offset": 0
                      }
                    }
                  },
                  "byTagName": {
                    "summary": "A page narrowed to hotels carrying a single named tag",
                    "value": {
                      "Data": [
                        {
                          "ID": "0192fb17-5dc6-7abc-8def-123456789abc",
                          "Name": "Bahia Azul Beach Resort",
                          "Names": {
                            "en-US": "Bahia Azul Beach Resort"
                          },
                          "ExternalHotelIDs": {
                            "ProductID": "HTL-MAJ-4711",
                            "Giata": "668370"
                          },
                          "GlobalHotelID": "ES-MALLR-K7MP2",
                          "Stars": 4,
                          "StarsMap": {
                            "default": {
                              "Stars": 4,
                              "Superior": false,
                              "Garni": false
                            }
                          },
                          "AccommodationType": "resort",
                          "Chain": "Meliá Hotels International",
                          "Brand": "Sol by Meliá",
                          "Location": {
                            "Latitude": 39.5696,
                            "Longitude": 2.6502,
                            "CountryCode": "ES"
                          },
                          "FactualAttributes": [],
                          "POIs": [],
                          "GeneratedTexts": {
                            "en-US": {
                              "Summary": {
                                "Text": "A family-run hotel in the hills, with a terrace restaurant and rooms that look out over the valley.",
                                "Compliance": {
                                  "AIGenerated": true
                                }
                              }
                            }
                          },
                          "GuestRating": {
                            "ReviewScore": 93,
                            "SubScores": {
                              "Cleanliness": 96,
                              "Facilities": 93,
                              "Food": 91,
                              "Location": 91,
                              "Rooms": 95,
                              "Service": 96,
                              "Value": 90
                            },
                            "Texts": {
                              "en-US": {
                                "Summary": "Guests consistently describe their stay as a peaceful, relaxing retreat highlighted by exceptionally friendly and attentive staff. Rooms and grounds are praised for being spotless and comfortable, while the delicious breakfast and calm adults-only setting make it an ideal getaway.",
                                "Pros": [
                                  "Warm, attentive, and professional staff",
                                  "Spotless rooms and well-kept grounds",
                                  "Peaceful, child-free atmosphere",
                                  "Superb and varied breakfast spread",
                                  "Modern, spacious guest rooms"
                                ],
                                "Cons": [
                                  "Extra charges for some premium drinks and minibar",
                                  "Lunch and dinner buffets can feel repetitive to some"
                                ],
                                "GeneratedAt": "2026-11-05T18:10:57Z",
                                "Compliance": {
                                  "AIGenerated": true
                                }
                              }
                            }
                          },
                          "Images": [],
                          "Rooms": [],
                          "Tags": [
                            {
                              "ID": "0192fc01-1111-7abc-8def-aaaaaaaaaaaa",
                              "Name": "Summer Campaign"
                            }
                          ],
                          "Status": "active",
                          "TextStatus": "generated",
                          "CreatedAt": "2026-03-01T08:00:00Z",
                          "UpdatedAt": "2026-04-12T09:15:00Z"
                        }
                      ],
                      "Pagination": {
                        "Total": 1,
                        "Limit": 50,
                        "Offset": 0
                      }
                    }
                  },
                  "byExternalHotelID": {
                    "summary": "A page narrowed to hotels matching the supplied external-identity selectors",
                    "value": {
                      "Data": [
                        {
                          "ID": "0192fb17-5dc6-7abc-8def-123456789abc",
                          "Name": "Bahia Azul Beach Resort",
                          "Names": {
                            "en-US": "Bahia Azul Beach Resort"
                          },
                          "ExternalHotelIDs": {
                            "ProductID": "HTL-MAJ-4711",
                            "Giata": "668370"
                          },
                          "GlobalHotelID": "ES-MALLR-K7MP2",
                          "Stars": 4,
                          "StarsMap": {
                            "default": {
                              "Stars": 4,
                              "Superior": false,
                              "Garni": false
                            }
                          },
                          "AccommodationType": "resort",
                          "Chain": "Meliá Hotels International",
                          "Brand": "Sol by Meliá",
                          "Location": {
                            "Latitude": 39.5696,
                            "Longitude": 2.6502,
                            "CountryCode": "ES"
                          },
                          "FactualAttributes": [],
                          "POIs": [],
                          "GeneratedTexts": {
                            "en-US": {
                              "Summary": {
                                "Text": "Close to the harbour, the hotel combines a sea-view breakfast room with simple, well-kept rooms.",
                                "Compliance": {
                                  "AIGenerated": true
                                }
                              }
                            }
                          },
                          "GuestRating": {
                            "ReviewScore": 93,
                            "SubScores": {
                              "Cleanliness": 96,
                              "Facilities": 93,
                              "Food": 91,
                              "Location": 91,
                              "Rooms": 95,
                              "Service": 96,
                              "Value": 90
                            },
                            "Texts": {
                              "en-US": {
                                "Summary": "Guests consistently describe their stay as a peaceful, relaxing retreat highlighted by exceptionally friendly and attentive staff. Rooms and grounds are praised for being spotless and comfortable, while the delicious breakfast and calm adults-only setting make it an ideal getaway.",
                                "Pros": [
                                  "Warm, attentive, and professional staff",
                                  "Spotless rooms and well-kept grounds",
                                  "Peaceful, child-free atmosphere",
                                  "Superb and varied breakfast spread",
                                  "Modern, spacious guest rooms"
                                ],
                                "Cons": [
                                  "Extra charges for some premium drinks and minibar",
                                  "Lunch and dinner buffets can feel repetitive to some"
                                ],
                                "GeneratedAt": "2026-11-05T18:10:57Z",
                                "Compliance": {
                                  "AIGenerated": true
                                }
                              }
                            }
                          },
                          "Images": [],
                          "Rooms": [],
                          "Status": "active",
                          "TextStatus": "generated",
                          "CreatedAt": "2026-03-01T08:00:00Z",
                          "UpdatedAt": "2026-04-12T09:15:00Z"
                        },
                        {
                          "ID": "0192fb18-6ed7-7abc-8def-223456789abc",
                          "Name": "Costa Verde City Hotel",
                          "Names": {
                            "en-US": "Costa Verde City Hotel"
                          },
                          "ExternalHotelIDs": {
                            "ProductID": "ESVALEN0007",
                            "Giata": "7654321",
                            "PeakworkGoalID": "864522"
                          },
                          "Stars": 3,
                          "StarsMap": {
                            "default": {
                              "Stars": 3,
                              "Superior": false,
                              "Garni": false
                            }
                          },
                          "AccommodationType": "hotel",
                          "Location": {
                            "Latitude": 39.4699,
                            "Longitude": -0.3763,
                            "CountryCode": "ES"
                          },
                          "FactualAttributes": [],
                          "POIs": [],
                          "GeneratedTexts": {},
                          "Images": [],
                          "Rooms": [],
                          "Status": "draft",
                          "TextStatus": "none",
                          "CreatedAt": "2026-03-04T10:30:00Z",
                          "UpdatedAt": "2026-03-20T14:05:00Z"
                        }
                      ],
                      "Pagination": {
                        "Total": 2,
                        "Limit": 50,
                        "Offset": 0
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/listEnrichedHotels_BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/listEnrichedHotels_Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/listEnrichedHotels_Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/listEnrichedHotels_NotFound"
          },
          "429": {
            "$ref": "#/components/responses/listEnrichedHotels_TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/listEnrichedHotels_InternalServerError"
          }
        }
      }
    },
    "/v2/project/content/listTags": {
      "post": {
        "summary": "List tags",
        "description": "Return the calling project's internal tags as a plain array under Data (not paginated). The request body is empty.",
        "operationId": "listTags",
        "tags": [
          "Content Enrichment API/Tags"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Project-ID"
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ListTagsRequest"
              },
              "examples": {
                "empty": {
                  "summary": "No body required",
                  "value": {}
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tags retrieved successfully.",
            "headers": {
              "X-Trace-ID": {
                "$ref": "#/components/headers/X-Trace-ID"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListTagsResponse"
                },
                "examples": {
                  "empty": {
                    "summary": "A project with two tags",
                    "value": {
                      "Data": [
                        {
                          "ID": "0192fc01-1111-7abc-8def-aaaaaaaaaaaa",
                          "ProjectID": "0192fa00-0000-7abc-8def-000000000000",
                          "Name": "Summer Campaign",
                          "CreatedBy": "editor@example.com"
                        },
                        {
                          "ID": "0192fc02-2222-7abc-8def-bbbbbbbbbbbb",
                          "ProjectID": "0192fa00-0000-7abc-8def-000000000000",
                          "Name": "Beachfront",
                          "CreatedBy": "project:0192fa00-0000-7abc-8def-000000000000"
                        }
                      ]
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/listTags_BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/listTags_Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/listTags_Forbidden"
          },
          "429": {
            "$ref": "#/components/responses/listTags_TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/listTags_InternalServerError"
          }
        }
      }
    },
    "/v2/project/content/listTextTemplates": {
      "post": {
        "summary": "List text templates",
        "description": "Return the text templates configured for the calling project, ordered by template key.\n\nText templates control the generated texts produced during enrichment. Each template targets a hotel or a room and carries a default authoring instruction with optional per-locale overrides. Results can be filtered by lifecycle status and by target entity type, and are paginated.",
        "operationId": "listTextTemplates",
        "tags": [
          "Content Enrichment API/Templates"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Project-ID"
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ListTextTemplatesRequest"
              },
              "examples": {
                "allTemplates": {
                  "summary": "List all templates (default pagination)",
                  "value": {
                    "Limit": 50,
                    "Offset": 0
                  }
                },
                "activeHotelTemplates": {
                  "summary": "Active hotel templates only, with usage stats",
                  "value": {
                    "Status": "active",
                    "EntityType": "hotel",
                    "IncludeStats": true,
                    "Limit": 50,
                    "Offset": 0
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Text templates retrieved successfully.",
            "headers": {
              "X-Trace-ID": {
                "$ref": "#/components/headers/X-Trace-ID"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListTextTemplatesResponse"
                },
                "examples": {
                  "allTemplates": {
                    "summary": "A project's hotel and room templates",
                    "value": {
                      "Data": [
                        {
                          "ID": "0192fb40-1aa2-7def-9abc-1122334455aa",
                          "ProjectID": "0192fb00-0000-7000-8000-000000000001",
                          "TemplateKey": "summary",
                          "Name": "Hotel Summary",
                          "EntityType": "hotel",
                          "Description": "Short marketing summary shown at the top of the hotel page.",
                          "Instruction": "Write a concise, factual two-sentence summary highlighting the hotel's location, standout amenity, and overall character. Avoid superlatives.",
                          "LocaleInstructions": {
                            "de-DE": "Schreibe eine sachliche Zusammenfassung in zwei Saetzen und verwende die Sie-Form."
                          },
                          "Status": "active",
                          "RenderLayout": "prose",
                          "CreatedAt": "2026-03-01T08:00:00Z",
                          "UpdatedAt": "2026-04-10T12:30:00Z"
                        },
                        {
                          "ID": "0192fb40-2bb3-7def-9abc-2233445566bb",
                          "ProjectID": "0192fb00-0000-7000-8000-000000000001",
                          "TemplateKey": "room_description",
                          "Name": "Room Description",
                          "EntityType": "room",
                          "Description": "Per-room descriptive paragraph used on room cards.",
                          "Instruction": "Describe the room in one short paragraph: size, bedding, view, and the most notable in-room features. Keep it neutral and concrete.",
                          "LocaleInstructions": {},
                          "Status": "active",
                          "RenderLayout": "roomcards",
                          "CreatedAt": "2026-03-01T08:00:00Z",
                          "UpdatedAt": "2026-03-01T08:00:00Z"
                        }
                      ],
                      "Pagination": {
                        "Total": 2,
                        "Limit": 50,
                        "Offset": 0
                      }
                    }
                  },
                  "activeHotelTemplates": {
                    "summary": "Active hotel templates with usage statistics",
                    "value": {
                      "Data": [
                        {
                          "ID": "0192fb40-1aa2-7def-9abc-1122334455aa",
                          "ProjectID": "0192fb00-0000-7000-8000-000000000001",
                          "TemplateKey": "summary",
                          "Name": "Hotel Summary",
                          "EntityType": "hotel",
                          "Description": "Short marketing summary shown at the top of the hotel page.",
                          "Instruction": "Write a concise, factual two-sentence summary highlighting the hotel's location, standout amenity, and overall character. Avoid superlatives.",
                          "LocaleInstructions": {
                            "de-DE": "Schreibe eine sachliche Zusammenfassung in zwei Saetzen und verwende die Sie-Form."
                          },
                          "Status": "active",
                          "RenderLayout": "prose",
                          "CreatedAt": "2026-03-01T08:00:00Z",
                          "UpdatedAt": "2026-04-10T12:30:00Z",
                          "UsageStats": {
                            "TextCount": 1240,
                            "HotelCount": 620,
                            "LastGeneratedAt": "2026-04-12T09:15:00Z"
                          }
                        }
                      ],
                      "Pagination": {
                        "Total": 1,
                        "Limit": 50,
                        "Offset": 0
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/listTextTemplates_BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/listTextTemplates_Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/listTextTemplates_Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/listTextTemplates_NotFound"
          },
          "429": {
            "$ref": "#/components/responses/listTextTemplates_TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/listTextTemplates_InternalServerError"
          }
        }
      }
    },
    "/v2/project/content/previewText": {
      "post": {
        "summary": "Preview text",
        "description": "Synchronously report what a text-generation run would change for a selection of the project's hotels, without generating any text or writing anything. Returns, per hotel, the per-template-and-locale freshness status (missing, fresh, stale), a what-changed summary of refreshed source categories, and the number of texts a fill_missing run would generate.\n\nHotels are selected by HotelIDs and/or TagIDs (combined and deduplicated, capped at 100), and every selected hotel must belong to the calling project.",
        "operationId": "previewText",
        "tags": [
          "Content Enrichment API/Text Generation"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Project-ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PreviewTextRequest"
              },
              "examples": {
                "byHotelIDs": {
                  "summary": "Preview all active templates for one hotel",
                  "value": {
                    "HotelIDs": [
                      "0192fb17-5dc6-7abc-8def-123456789abc"
                    ]
                  }
                },
                "scopedPreview": {
                  "summary": "Preview a single template in two locales",
                  "value": {
                    "HotelIDs": [
                      "0192fb17-5dc6-7abc-8def-123456789abc"
                    ],
                    "TemplateKeys": [
                      "Summary"
                    ],
                    "Locales": [
                      "en-US",
                      "de-DE"
                    ]
                  }
                },
                "byTag": {
                  "summary": "Preview every project hotel carrying a tag",
                  "value": {
                    "TagIDs": [
                      "0192fb40-7aa1-7abc-8def-aabbccddeeff"
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Preview computed successfully.",
            "headers": {
              "X-Trace-ID": {
                "$ref": "#/components/headers/X-Trace-ID"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PreviewTextResponse"
                },
                "examples": {
                  "byHotelIDs": {
                    "summary": "A hotel with one missing and one stale text",
                    "value": {
                      "Data": {
                        "Hotels": [
                          {
                            "HotelID": "0192fb17-5dc6-7abc-8def-123456789abc",
                            "HotelName": "Bahia Azul Beach Resort",
                            "Texts": [
                              {
                                "TemplateKey": "Summary",
                                "EntityType": "hotel",
                                "Locale": "en-US",
                                "Status": "fresh",
                                "Count": 0
                              },
                              {
                                "TemplateKey": "Summary",
                                "EntityType": "hotel",
                                "Locale": "de-DE",
                                "Status": "missing",
                                "Count": 1
                              },
                              {
                                "TemplateKey": "HouseRules",
                                "EntityType": "hotel",
                                "Locale": "en-US",
                                "Status": "stale",
                                "Count": 1
                              },
                              {
                                "TemplateKey": "RoomDescription",
                                "EntityType": "room",
                                "Locale": "en-US",
                                "Status": "missing",
                                "Count": 3
                              }
                            ],
                            "WhatChanged": [
                              {
                                "Category": "attributes",
                                "CompletedAt": "2026-06-25T14:02:00Z"
                              },
                              {
                                "Category": "images",
                                "CompletedAt": "2026-06-24T18:30:00Z"
                              }
                            ],
                            "TextsToGenerate": 5
                          }
                        ],
                        "TotalTextsToGenerate": 5
                      }
                    }
                  },
                  "scopedPreview": {
                    "summary": "A single template previewed in two locales",
                    "value": {
                      "Data": {
                        "Hotels": [
                          {
                            "HotelID": "0192fb17-5dc6-7abc-8def-123456789abc",
                            "HotelName": "Bahia Azul Beach Resort",
                            "Texts": [
                              {
                                "TemplateKey": "Summary",
                                "EntityType": "hotel",
                                "Locale": "en-US",
                                "Status": "fresh",
                                "Count": 0
                              },
                              {
                                "TemplateKey": "Summary",
                                "EntityType": "hotel",
                                "Locale": "de-DE",
                                "Status": "missing",
                                "Count": 1
                              }
                            ],
                            "WhatChanged": [],
                            "TextsToGenerate": 1
                          }
                        ],
                        "TotalTextsToGenerate": 1
                      }
                    }
                  },
                  "byTag": {
                    "summary": "Two tag-resolved hotels, everything already fresh",
                    "value": {
                      "Data": {
                        "Hotels": [
                          {
                            "HotelID": "0192fb17-5dc6-7abc-8def-123456789abc",
                            "HotelName": "Bahia Azul Beach Resort",
                            "Texts": [
                              {
                                "TemplateKey": "Summary",
                                "EntityType": "hotel",
                                "Locale": "en-US",
                                "Status": "fresh",
                                "Count": 0
                              }
                            ],
                            "WhatChanged": [],
                            "TextsToGenerate": 0
                          },
                          {
                            "HotelID": "0192fb18-6ed7-7abc-8def-223456789abc",
                            "HotelName": "Costa Verde Garden Hotel",
                            "Texts": [
                              {
                                "TemplateKey": "Summary",
                                "EntityType": "hotel",
                                "Locale": "en-US",
                                "Status": "fresh",
                                "Count": 0
                              }
                            ],
                            "WhatChanged": [],
                            "TextsToGenerate": 0
                          }
                        ],
                        "TotalTextsToGenerate": 0
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/previewText_BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/previewText_Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/previewText_Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/previewText_NotFound"
          },
          "429": {
            "$ref": "#/components/responses/previewText_TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/previewText_InternalServerError"
          }
        }
      }
    },
    "/v2/project/content/rejectApprovalImageUpload": {
      "post": {
        "summary": "Reject approval image upload",
        "description": "Reject one pending photo upload: the upload's feedback item is rejected and the photo is never served. The page's photo list is not touched and the stored file is kept. The upload is checked when it is locked: one whose stored photo record is incomplete and cannot be read answers 400 `INVALID_STATUS_TRANSITION` (contact YGO support), and then an upload that was already decided answers 400 `INVALID_STATUS_TRANSITION`. Works after the hotel approved. The reviewer is recorded as the user's ID, or `project:<project id>` for a project API key.",
        "operationId": "rejectApprovalImageUpload",
        "tags": [
          "Content Enrichment API/Approval Links"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RejectApprovalImageUploadRequest"
              },
              "examples": {
                "reject": {
                  "summary": "Reject one pending upload",
                  "value": {
                    "HotelID": "019d9c2e-0ef8-7458-b0fa-8bed7182eb30",
                    "FeedbackID": "01a0f1c9-3e8a-7c12-b4d5-8e9f0a1b2c3d"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The rejected upload, `Status` `rejected` with its `ReviewedAt`.",
            "headers": {
              "X-Trace-ID": {
                "$ref": "#/components/headers/X-Trace-ID"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RejectApprovalImageUploadResponse"
                },
                "examples": {
                  "reject": {
                    "summary": "The photo is refused and never served",
                    "value": {
                      "Data": {
                        "ID": "01a0f1c9-3e8a-7c12-b4d5-8e9f0a1b2c3d",
                        "HotelID": "019d9c2e-0ef8-7458-b0fa-8bed7182eb30",
                        "URL": "https://ucarecdn.com/8f14e45f-ceea-467a-9575-7d3b1c2a9e10/",
                        "Width": 1600,
                        "Height": 1200,
                        "FileSize": 0,
                        "Format": "",
                        "Status": "rejected",
                        "CreatedAt": "2026-10-12T09:14:03.512874Z",
                        "ReviewedAt": "2026-10-12T11:02:39.660142Z"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/rejectApprovalImageUpload_BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/rejectApprovalImageUpload_InternalServerError"
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Project-ID"
          }
        ]
      }
    },
    "/v2/project/content/removeTagFromHotels": {
      "post": {
        "summary": "Remove tag from hotels (bulk)",
        "description": "Remove a project tag from up to 1000 hotels at once. Tag ownership is checked once (404 if foreign). Each valid hotel id has its link removed ('removed'); a malformed id is 'invalid'. Removal is idempotent (a non-existent link is a no-op) and runs no membership guard, since de-grouping never widens access.",
        "operationId": "removeTagFromHotels",
        "tags": [
          "Content Enrichment API/Tags"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Project-ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RemoveTagFromHotelsRequest"
              },
              "examples": {
                "bulk": {
                  "summary": "Remove a tag from several hotels",
                  "value": {
                    "TagID": "0192fc01-1111-7abc-8def-aaaaaaaaaaaa",
                    "HotelIDs": [
                      "0192fb17-5dc6-7abc-8def-123456789abc",
                      "0192fb18-6ed7-7abc-8def-223456789abc"
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Bulk remove processed. Each hotel id carries its own outcome.",
            "headers": {
              "X-Trace-ID": {
                "$ref": "#/components/headers/X-Trace-ID"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RemoveTagFromHotelsResponse"
                },
                "examples": {
                  "bulk": {
                    "summary": "A batch with one removed and one invalid id",
                    "value": {
                      "Data": {
                        "TagID": "0192fc01-1111-7abc-8def-aaaaaaaaaaaa",
                        "Results": [
                          {
                            "HotelID": "0192fb17-5dc6-7abc-8def-123456789abc",
                            "Status": "removed"
                          },
                          {
                            "HotelID": "not-a-uuid",
                            "Status": "invalid"
                          }
                        ]
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/removeTagFromHotels_BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/removeTagFromHotels_Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/removeTagFromHotels_Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/removeTagFromHotels_NotFound"
          },
          "429": {
            "$ref": "#/components/responses/removeTagFromHotels_TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/removeTagFromHotels_InternalServerError"
          }
        }
      }
    },
    "/v2/project/content/revokeApprovalLink": {
      "post": {
        "summary": "Revoke approval link",
        "description": "Revoke one hotel's approval link by stamping `RevokedAt`, and change nothing else. The token stops resolving immediately — the public approval endpoints answer the same 404 they give an unknown token — `rotateApprovalLink` answers 404, and a hotel that had not approved leaves `listApprovals`. The hotel's approval survives: status, approval timestamps, approver, contacts and feedback are all kept, and `exportApprovedHotelText` keeps working. Call `createApprovalLinks` to mint a fresh link for the hotel afterwards. Repeating the call is safe: the row comes back with its original `RevokedAt`.",
        "operationId": "revokeApprovalLink",
        "tags": [
          "Content Enrichment API/Approval Links"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RevokeApprovalLinkRequest"
              },
              "examples": {
                "revoke": {
                  "summary": "Revoke one hotel's link",
                  "value": {
                    "HotelID": "019d9c2e-0ef8-7458-b0fa-8bed7182eb30"
                  }
                },
                "revokeAgain": {
                  "summary": "Revoke again — the same request is safe",
                  "value": {
                    "HotelID": "019d9c2e-0ef8-7458-b0fa-8bed7182eb30"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The revoked link. `RevokedAt` is set and `Token` is never returned.",
            "headers": {
              "X-Trace-ID": {
                "$ref": "#/components/headers/X-Trace-ID"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RevokeApprovalLinkResponse"
                },
                "examples": {
                  "revoke": {
                    "summary": "Revoked link of an already approved hotel",
                    "value": {
                      "Data": {
                        "HotelID": "019d9c2e-0ef8-7458-b0fa-8bed7182eb30",
                        "HotelName": "Sotavento Beach Club",
                        "GiataID": 5721,
                        "MasterCode": "FUED0009",
                        "TokenPreview": "xPBOjXHo...",
                        "Status": "approved",
                        "ApprovedAt": "2026-08-25T18:19:18.860882Z",
                        "ApprovedTextGeneratedAt": "2026-08-19T14:14:57.674681Z",
                        "ApprovedBy": {
                          "Name": "Ayşe Yılmaz",
                          "Email": "ayse@sotavento.example",
                          "Phone": "+34 928 000 000"
                        },
                        "LastOpenedAt": "2026-08-25T18:19:18.966928Z",
                        "RevokedAt": "2026-08-25T18:19:19.602402Z",
                        "Created": false,
                        "CreatedBy": "editor@example.com",
                        "CreatedAt": "2026-08-25T18:19:17.522006Z",
                        "UpdatedAt": "2026-08-25T18:19:19.602402Z"
                      }
                    }
                  },
                  "revokeAgain": {
                    "summary": "Second revoke: the original RevokedAt is kept",
                    "value": {
                      "Data": {
                        "HotelID": "019d9c2e-0ef8-7458-b0fa-8bed7182eb30",
                        "HotelName": "Sotavento Beach Club",
                        "GiataID": 5721,
                        "MasterCode": "FUED0009",
                        "TokenPreview": "xPBOjXHo...",
                        "Status": "approved",
                        "ApprovedAt": "2026-08-25T18:19:18.860882Z",
                        "ApprovedTextGeneratedAt": "2026-08-19T14:14:57.674681Z",
                        "ApprovedBy": {
                          "Name": "Ayşe Yılmaz",
                          "Email": "ayse@sotavento.example",
                          "Phone": "+34 928 000 000"
                        },
                        "LastOpenedAt": "2026-08-25T18:19:18.966928Z",
                        "RevokedAt": "2026-08-25T18:19:19.602402Z",
                        "Created": false,
                        "CreatedBy": "editor@example.com",
                        "CreatedAt": "2026-08-25T18:19:17.522006Z",
                        "UpdatedAt": "2026-08-25T18:19:19.602402Z"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/revokeApprovalLink_BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/revokeApprovalLink_NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/revokeApprovalLink_InternalServerError"
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Project-ID"
          }
        ]
      }
    },
    "/v2/project/content/rotateApprovalLink": {
      "post": {
        "summary": "Rotate approval link",
        "description": "Replace one hotel's link token. The old token stops resolving immediately, so this is how a leaked or mis-sent link is invalidated. Everything else survives: the approval status, the approval timestamps and approver, the feedback history and the hotel's identified contacts, whose secrets keep working on the new token. Send the new link to the hotel afterwards — the old one is dead. A link that was revoked cannot be rotated back to life: it answers 404 `Approval link not found`, and `createApprovalLinks` is the way to mint a fresh one.",
        "operationId": "rotateApprovalLink",
        "tags": [
          "Content Enrichment API/Approval Links"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RotateApprovalLinkRequest"
              },
              "examples": {
                "rotate": {
                  "summary": "Rotate one hotel's link",
                  "value": {
                    "HotelID": "019d9c2e-0ef8-7458-b0fa-8bed7182eb30"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The link with its new token. The previous token no longer resolves.",
            "headers": {
              "X-Trace-ID": {
                "$ref": "#/components/headers/X-Trace-ID"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RotateApprovalLinkResponse"
                },
                "examples": {
                  "rotate": {
                    "summary": "Rotated link of an already approved hotel",
                    "value": {
                      "Data": {
                        "HotelID": "019d9c2e-0ef8-7458-b0fa-8bed7182eb30",
                        "HotelName": "Sotavento Beach Club",
                        "GiataID": 5721,
                        "MasterCode": "FUED0009",
                        "Token": "cP7tpTJPwR9mLxYaKu2NsE4vZbQdHfGjT1oIcXn6yA0",
                        "TokenPreview": "cP7tpTJP...",
                        "Status": "approved",
                        "ApprovedAt": "2026-08-25T18:19:18.860882Z",
                        "ApprovedTextGeneratedAt": "2026-08-19T14:14:57.674681Z",
                        "ApprovedBy": {
                          "Name": "Ayşe Yılmaz",
                          "Email": "ayse@sotavento.example",
                          "Phone": "+34 928 000 000"
                        },
                        "LastOpenedAt": "2026-08-25T18:19:18.966928Z",
                        "Created": false,
                        "CreatedBy": "editor@example.com",
                        "CreatedAt": "2026-08-25T18:19:17.522006Z",
                        "UpdatedAt": "2026-08-25T18:19:18.860882Z"
                      }
                    }
                  },
                  "projectTokenCaller": {
                    "summary": "Same call with a proj_ project token — contact PII omitted: ApprovedBy carries Name only and CreatedBy is absent",
                    "value": {
                      "Data": {
                        "HotelID": "019d9c2e-0ef8-7458-b0fa-8bed7182eb30",
                        "HotelName": "Sotavento Beach Club",
                        "GiataID": 5721,
                        "MasterCode": "FUED0009",
                        "Token": "cP7tpTJPwR9mLxYaKu2NsE4vZbQdHfGjT1oIcXn6yA0",
                        "TokenPreview": "cP7tpTJP...",
                        "Status": "approved",
                        "ApprovedAt": "2026-08-25T18:19:18.860882Z",
                        "ApprovedTextGeneratedAt": "2026-08-19T14:14:57.674681Z",
                        "ApprovedBy": {
                          "Name": "Ayşe Yılmaz"
                        },
                        "LastOpenedAt": "2026-08-25T18:19:18.966928Z",
                        "Created": false,
                        "CreatedAt": "2026-08-25T18:19:17.522006Z",
                        "UpdatedAt": "2026-08-25T18:19:18.860882Z"
                      }
                    },
                    "description": "Identical request, answered for a caller presenting a `proj_` project token instead of a `user_` token. `ApprovedBy.Email`, `ApprovedBy.Phone` and `CreatedBy` are contact PII and are omitted entirely (the keys are absent, not empty strings). Everything else is unchanged."
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/rotateApprovalLink_BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/rotateApprovalLink_NotFound"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/rotateApprovalLink_InternalServerError"
          }
        },
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Project-ID"
          }
        ]
      }
    },
    "/v2/project/content/saveHotelImagePin": {
      "post": {
        "summary": "Save hotel image pin",
        "description": "Pin one of a hotel's images as the first image of the served gallery. Upsert: each hotel carries at most one pin per project, and saving replaces any previous pin. The hotel must belong to the calling project (404 otherwise), the image must belong to that hotel (404 otherwise) and be active (400 otherwise), and a room-level image can be pinned only while the hotel has no hotel-level images (400 otherwise).",
        "operationId": "saveHotelImagePin",
        "tags": [
          "Content Enrichment API/Image Pins"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Project-ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SaveHotelImagePinRequest"
              },
              "examples": {
                "pinImage": {
                  "summary": "Pin an image as the hotel's first gallery image",
                  "value": {
                    "HotelID": "0192fb17-5dc6-7abc-8def-123456789abc",
                    "ImageID": "0192fb20-1aa2-7def-9abc-1122334455aa"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Image pinned successfully. Any previous pin for this hotel was replaced.",
            "headers": {
              "X-Trace-ID": {
                "$ref": "#/components/headers/X-Trace-ID"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SaveHotelImagePinResponse"
                },
                "examples": {
                  "pinImage": {
                    "summary": "The saved pin",
                    "value": {
                      "Data": {
                        "HotelID": "0192fb17-5dc6-7abc-8def-123456789abc",
                        "ImageID": "0192fb20-1aa2-7def-9abc-1122334455aa",
                        "CreatedBy": "editor@example.com"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/saveHotelImagePin_BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/saveHotelImagePin_Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/saveHotelImagePin_Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/saveHotelImagePin_NotFound"
          },
          "429": {
            "$ref": "#/components/responses/saveHotelImagePin_TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/saveHotelImagePin_InternalServerError"
          }
        }
      }
    },
    "/v2/project/content/saveHotelStars": {
      "post": {
        "summary": "Save hotel stars",
        "description": "Set your project's own star grade for one hotel. Upsert: each hotel carries at most one grade per project, and saving replaces any previous grade. This project's getEnrichedHotel, listEnrichedHotels and listEnrichedHotelSummaries then serve it as StarsMap.project and StarsMap.default, and as the top-level Stars (normally on the next read, at the latest about a minute later); no other project sees the grade. The hotel must belong to the calling project (404 otherwise), Stars must be greater than 0 and at most 10 with at most one decimal, and Superior must not be sent: a project grade has no Superior (400 otherwise).",
        "operationId": "saveHotelStars",
        "tags": [
          "Content Enrichment API/Hotel Stars"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Project-ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SaveHotelStarsRequest"
              },
              "examples": {
                "halfStarGrade": {
                  "summary": "Grade a hotel 4.5 stars",
                  "value": {
                    "HotelID": "0192fb17-5dc6-7abc-8def-123456789abc",
                    "Stars": 4.5
                  }
                },
                "wholeStarGrade": {
                  "summary": "Grade a hotel 4 stars",
                  "value": {
                    "HotelID": "0192fb17-5dc6-7abc-8def-123456789abc",
                    "Stars": 4
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Grade saved. Any previous grade of this project for the hotel was replaced.",
            "headers": {
              "X-Trace-ID": {
                "$ref": "#/components/headers/X-Trace-ID"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SaveHotelStarsResponse"
                },
                "examples": {
                  "halfStarGrade": {
                    "summary": "The saved grade",
                    "value": {
                      "Data": {
                        "HotelID": "0192fb17-5dc6-7abc-8def-123456789abc",
                        "Stars": 4.5
                      }
                    }
                  },
                  "wholeStarGrade": {
                    "summary": "The saved grade, a whole star",
                    "value": {
                      "Data": {
                        "HotelID": "0192fb17-5dc6-7abc-8def-123456789abc",
                        "Stars": 4
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/saveHotelStars_BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/saveHotelStars_Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/saveHotelStars_Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/saveHotelStars_NotFound"
          },
          "429": {
            "$ref": "#/components/responses/saveHotelStars_TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/saveHotelStars_InternalServerError"
          }
        }
      }
    },
    "/v2/project/content/saveTag": {
      "post": {
        "summary": "Save tag",
        "description": "Upsert a project tag. Omit TagID to create a new tag or supply an existing TagID to rename it. The name must be unique within the project (case-insensitive); a duplicate returns 409, and renaming a tag id not in the project returns 404.",
        "operationId": "saveTag",
        "tags": [
          "Content Enrichment API/Tags"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Project-ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SaveTagRequest"
              },
              "examples": {
                "create": {
                  "summary": "Create a new tag (no TagID)",
                  "value": {
                    "Name": "Summer Campaign"
                  }
                },
                "rename": {
                  "summary": "Rename an existing tag (TagID + new Name)",
                  "value": {
                    "TagID": "0192fc01-1111-7abc-8def-aaaaaaaaaaaa",
                    "Name": "Summer 2026 Campaign"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tag created or renamed successfully.",
            "headers": {
              "X-Trace-ID": {
                "$ref": "#/components/headers/X-Trace-ID"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SaveTagResponse"
                },
                "examples": {
                  "create": {
                    "summary": "A newly created tag",
                    "value": {
                      "Data": {
                        "ID": "0192fc01-1111-7abc-8def-aaaaaaaaaaaa",
                        "ProjectID": "0192fa00-0000-7abc-8def-000000000000",
                        "Name": "Summer Campaign",
                        "CreatedBy": "editor@example.com"
                      }
                    }
                  },
                  "rename": {
                    "summary": "A renamed tag (CreatedBy preserved)",
                    "value": {
                      "Data": {
                        "ID": "0192fc01-1111-7abc-8def-aaaaaaaaaaaa",
                        "ProjectID": "0192fa00-0000-7abc-8def-000000000000",
                        "Name": "Summer 2026 Campaign",
                        "CreatedBy": "editor@example.com"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/saveTag_BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/saveTag_Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/saveTag_Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/saveTag_NotFound"
          },
          "409": {
            "$ref": "#/components/responses/saveTag_Conflict"
          },
          "429": {
            "$ref": "#/components/responses/saveTag_TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/saveTag_InternalServerError"
          }
        }
      }
    },
    "/v2/project/content/saveTextTemplate": {
      "post": {
        "summary": "Save text template",
        "description": "Create a new text template or update an existing one. The template is matched within the project by its TemplateKey: an existing key updates that template, a new key creates one. The saved template is returned.\n\nTemplateKey, EntityType, and Instruction are required. The default Instruction and each per-locale instruction are checked for safety before the template is stored.",
        "operationId": "saveTextTemplate",
        "tags": [
          "Content Enrichment API/Templates"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Project-ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SaveTextTemplateRequest"
              },
              "examples": {
                "createNew": {
                  "summary": "Create a new hotel summary template",
                  "value": {
                    "TemplateKey": "summary",
                    "Name": "Hotel Summary",
                    "EntityType": "hotel",
                    "Description": "Short marketing summary shown at the top of the hotel page.",
                    "Instruction": "Write a concise, factual two-sentence summary highlighting the hotel's location, standout amenity, and overall character. Avoid superlatives.",
                    "LocaleInstructions": {
                      "de-DE": "Schreibe eine sachliche Zusammenfassung in zwei Saetzen und verwende die Sie-Form."
                    },
                    "Status": "active",
                    "RenderLayout": "prose"
                  }
                },
                "updateExisting": {
                  "summary": "Update the room description template's instruction",
                  "value": {
                    "TemplateKey": "room_description",
                    "Name": "Room Description",
                    "EntityType": "room",
                    "Description": "Per-room descriptive paragraph used on room cards.",
                    "Instruction": "Describe the room in one short paragraph: size, bedding, view, and the most notable in-room features. Mention any balcony or terrace. Keep it neutral and concrete.",
                    "LocaleInstructions": {},
                    "Status": "active",
                    "RenderLayout": "roomcards"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Text template created or updated successfully. Returns the saved template.",
            "headers": {
              "X-Trace-ID": {
                "$ref": "#/components/headers/X-Trace-ID"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SaveTextTemplateResponse"
                },
                "examples": {
                  "createNew": {
                    "summary": "Newly created hotel summary template",
                    "value": {
                      "Data": {
                        "ID": "0192fb40-1aa2-7def-9abc-1122334455aa",
                        "ProjectID": "0192fb00-0000-7000-8000-000000000001",
                        "TemplateKey": "summary",
                        "Name": "Hotel Summary",
                        "EntityType": "hotel",
                        "Description": "Short marketing summary shown at the top of the hotel page.",
                        "Instruction": "Write a concise, factual two-sentence summary highlighting the hotel's location, standout amenity, and overall character. Avoid superlatives.",
                        "LocaleInstructions": {
                          "de-DE": "Schreibe eine sachliche Zusammenfassung in zwei Saetzen und verwende die Sie-Form."
                        },
                        "Status": "active",
                        "RenderLayout": "prose",
                        "CreatedAt": "2026-04-12T09:15:00Z",
                        "UpdatedAt": "2026-04-12T09:15:00Z"
                      }
                    }
                  },
                  "updateExisting": {
                    "summary": "Updated room description template",
                    "value": {
                      "Data": {
                        "ID": "0192fb40-2bb3-7def-9abc-2233445566bb",
                        "ProjectID": "0192fb00-0000-7000-8000-000000000001",
                        "TemplateKey": "room_description",
                        "Name": "Room Description",
                        "EntityType": "room",
                        "Description": "Per-room descriptive paragraph used on room cards.",
                        "Instruction": "Describe the room in one short paragraph: size, bedding, view, and the most notable in-room features. Mention any balcony or terrace. Keep it neutral and concrete.",
                        "LocaleInstructions": {},
                        "Status": "active",
                        "RenderLayout": "roomcards",
                        "CreatedAt": "2026-03-01T08:00:00Z",
                        "UpdatedAt": "2026-04-12T09:15:00Z"
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/saveTextTemplate_BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/saveTextTemplate_Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/saveTextTemplate_Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/saveTextTemplate_NotFound"
          },
          "409": {
            "$ref": "#/components/responses/saveTextTemplate_Conflict"
          },
          "429": {
            "$ref": "#/components/responses/saveTextTemplate_TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/saveTextTemplate_InternalServerError"
          }
        }
      }
    },
    "/v2/project/content/vision/deleteImages": {
      "post": {
        "summary": "Delete vision images",
        "description": "Delete images this project submitted, by image ID.\n\nSynchronous. A delete removes your access, not the picture or its analysis; other clients keep the image.\n\n- Requires an org admin's or owner's user token; a project API key gets 403.\n- 1 to 100 image IDs per request; one entry per ID, in request order.\n- `Status` is `deleted` or `not_found`; an ID you do not own reports `not_found`.\n- Idempotent: an already deleted image answers `deleted` again.\n- The image leaves `listImages`, `getImages` and your `getEnrichedHotel` gallery, and its pin is cleared.\n- Submitting the URL again restores it under the same image ID, unbilled.\n- 404 means Vision AI is not enabled for your project.",
        "operationId": "deleteVisionImages",
        "tags": [
          "Content Enrichment API/Vision AI"
        ],
        "security": [
          {
            "deleteVisionImages_bearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Project-ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DeleteVisionImagesRequest"
              },
              "examples": {
                "twoImages": {
                  "summary": "Delete two images you uploaded",
                  "value": {
                    "ImageIDs": [
                      "0192fb20-1aa2-7def-9abc-1122334455aa",
                      "0192fb21-2bb3-7def-9abc-2233445566bb"
                    ]
                  }
                },
                "oneNotOwned": {
                  "summary": "One of your images and one ID this project never submitted",
                  "value": {
                    "ImageIDs": [
                      "0192fb20-1aa2-7def-9abc-1122334455aa",
                      "0192fb99-9ff9-7def-9abc-999999999999"
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "One entry per requested image ID, in request order. A batch in which every ID answers not_found is still a 200.",
            "headers": {
              "X-Trace-ID": {
                "$ref": "#/components/headers/X-Trace-ID"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeleteVisionImagesResponse"
                },
                "examples": {
                  "allDeleted": {
                    "summary": "Both images were this project's and are now deleted",
                    "value": {
                      "Data": {
                        "Images": [
                          {
                            "ImageID": "0192fb20-1aa2-7def-9abc-1122334455aa",
                            "Status": "deleted"
                          },
                          {
                            "ImageID": "0192fb21-2bb3-7def-9abc-2233445566bb",
                            "Status": "deleted"
                          }
                        ]
                      }
                    }
                  },
                  "mixed": {
                    "summary": "One deleted, one ID this project does not own",
                    "value": {
                      "Data": {
                        "Images": [
                          {
                            "ImageID": "0192fb20-1aa2-7def-9abc-1122334455aa",
                            "Status": "deleted"
                          },
                          {
                            "ImageID": "0192fb99-9ff9-7def-9abc-999999999999",
                            "Status": "not_found"
                          }
                        ]
                      }
                    }
                  },
                  "repeatCall": {
                    "summary": "The same call again: an already-deleted image still answers deleted",
                    "value": {
                      "Data": {
                        "Images": [
                          {
                            "ImageID": "0192fb20-1aa2-7def-9abc-1122334455aa",
                            "Status": "deleted"
                          }
                        ]
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/deleteVisionImages_BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/deleteVisionImages_Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/deleteVisionImages_Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/deleteVisionImages_NotFound"
          },
          "429": {
            "$ref": "#/components/responses/deleteVisionImages_TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/deleteVisionImages_InternalServerError"
          }
        }
      }
    },
    "/v2/project/content/vision/getImages": {
      "post": {
        "summary": "Get vision images",
        "description": "Fetch the analysis state of submitted images by image ID, with the enriched image object for every image that is complete.\n\nAnalysis runs asynchronously after `ingestVisionImages`, so an image reports `pending` until it finishes. Poll every 30 to 60 seconds until each ID reaches `completed`, `failed` or `not_found`.\n\n- 1 to 100 image IDs per request.\n- One entry per requested ID, in request order, so entries can be matched positionally.\n- `Status` is `pending`, `completed`, `failed` or `not_found`; only `completed` carries `Image`.\n- An ID this project never submitted reports `not_found`, never an error.\n- 404 means Vision AI is not enabled for your project.\n- 429 means the rate limit was hit; wait `Retry-After` seconds.",
        "operationId": "getVisionImages",
        "tags": [
          "Content Enrichment API/Vision AI"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Project-ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/GetVisionImagesRequest"
              },
              "examples": {
                "mixedStatuses": {
                  "summary": "Poll four image IDs from an in-flight batch",
                  "value": {
                    "ImageIDs": [
                      "0192fb20-1aa2-7def-9abc-1122334455aa",
                      "0192fb21-2bb3-7def-9abc-2233445566bb",
                      "0192fb22-3cc4-7def-9abc-3344556677cc",
                      "0192fb99-9ff9-7def-9abc-999999999999"
                    ]
                  }
                },
                "allCompleted": {
                  "summary": "Poll two image IDs whose analysis has finished",
                  "value": {
                    "ImageIDs": [
                      "0192fb21-2bb3-7def-9abc-2233445566bb",
                      "0192fb23-4dd5-7def-9abc-4455667788dd"
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "One entry per requested image ID, in request order.",
            "headers": {
              "X-Trace-ID": {
                "$ref": "#/components/headers/X-Trace-ID"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetVisionImagesResponse"
                },
                "examples": {
                  "mixedStatuses": {
                    "summary": "One completed image, one still being analyzed, one unreachable URL and one unknown ID",
                    "value": {
                      "Data": {
                        "Images": [
                          {
                            "ImageID": "0192fb20-1aa2-7def-9abc-1122334455aa",
                            "Status": "pending"
                          },
                          {
                            "ImageID": "0192fb21-2bb3-7def-9abc-2233445566bb",
                            "Status": "completed",
                            "RoomRef": "DBL-SEA",
                            "Image": {
                              "ID": "0192fb21-2bb3-7def-9abc-2233445566bb",
                              "URL": "https://images.example-client.com/1234567/room-dbl-sea-1.jpg",
                              "Source": "photo",
                              "Category": "room",
                              "Features": [
                                "sea_view",
                                "balcony",
                                "double_bed"
                              ],
                              "Mood": [
                                "bright",
                                "calm"
                              ],
                              "Tags": [
                                "sea_view"
                              ],
                              "AppealScore": 82,
                              "QualityScore": 77,
                              "AppealScoreVersion": "app-v4",
                              "QualityScoreVersion": "qs-v4",
                              "Width": 1600,
                              "Height": 1067,
                              "Format": "jpeg",
                              "FileSize": 412000,
                              "DominantColor": "#2E6F95",
                              "BlurHash": "LEHV6nWB2yk8pyo0adR*",
                              "Descriptions": {
                                "en-US": "Double room with a balcony overlooking the sea.",
                                "de-DE": "Doppelzimmer mit Balkon und Meerblick."
                              },
                              "Compliance": {
                                "AIGenerated": true
                              },
                              "FeatureDetections": [
                                {
                                  "Label": "sea_view",
                                  "Confidence": 0.94
                                },
                                {
                                  "Label": "balcony",
                                  "Confidence": 0.88
                                }
                              ]
                            }
                          },
                          {
                            "ImageID": "0192fb22-3cc4-7def-9abc-3344556677cc",
                            "Status": "failed",
                            "RoomRef": "SUITE-1"
                          },
                          {
                            "ImageID": "0192fb99-9ff9-7def-9abc-999999999999",
                            "Status": "not_found"
                          }
                        ]
                      }
                    }
                  },
                  "allCompleted": {
                    "summary": "Both images analyzed, one of them carrying the measured detection domains",
                    "value": {
                      "Data": {
                        "Images": [
                          {
                            "ImageID": "0192fb21-2bb3-7def-9abc-2233445566bb",
                            "Status": "completed",
                            "RoomRef": "DBL-SEA",
                            "Image": {
                              "ID": "0192fb21-2bb3-7def-9abc-2233445566bb",
                              "URL": "https://images.example-client.com/1234567/room-dbl-sea-1.jpg",
                              "Source": "photo",
                              "Category": "room",
                              "Features": [
                                "sea_view",
                                "balcony",
                                "double_bed"
                              ],
                              "Mood": [
                                "bright",
                                "calm"
                              ],
                              "Tags": [
                                "sea_view"
                              ],
                              "AppealScore": 82,
                              "QualityScore": 77,
                              "AppealScoreVersion": "app-v4",
                              "QualityScoreVersion": "qs-v4",
                              "Width": 1600,
                              "Height": 1067,
                              "Format": "jpeg",
                              "FileSize": 412000,
                              "DominantColor": "#2E6F95",
                              "BlurHash": "LEHV6nWB2yk8pyo0adR*",
                              "Descriptions": {
                                "en-US": "Double room with a balcony overlooking the sea.",
                                "de-DE": "Doppelzimmer mit Balkon und Meerblick."
                              },
                              "Compliance": {
                                "AIGenerated": true
                              },
                              "FeatureDetections": [
                                {
                                  "Label": "sea_view",
                                  "Confidence": 0.94
                                },
                                {
                                  "Label": "balcony",
                                  "Confidence": 0.88
                                }
                              ]
                            }
                          },
                          {
                            "ImageID": "0192fb23-4dd5-7def-9abc-4455667788dd",
                            "Status": "completed",
                            "Image": {
                              "ID": "0192fb23-4dd5-7def-9abc-4455667788dd",
                              "URL": "https://images.example-client.com/1234567/exterior-pool.jpg",
                              "Source": "photo",
                              "Category": "pool",
                              "Features": [
                                "outdoor_pool",
                                "sun_loungers"
                              ],
                              "Mood": [
                                "relaxing"
                              ],
                              "Tags": [
                                "sunset"
                              ],
                              "Flags": [
                                "people_present"
                              ],
                              "AppealScore": 91,
                              "QualityScore": 88,
                              "AppealScoreVersion": "app-v4",
                              "QualityScoreVersion": "qs-v4",
                              "Width": 2048,
                              "Height": 1365,
                              "Format": "jpeg",
                              "FileSize": 738000,
                              "DominantColor": "#1F5D7A",
                              "BlurHash": "LKO2?U%2Tw=w]~RBVZRi};RPxuwH",
                              "FileMetadata": {
                                "CaptureDate": "2012-06-14",
                                "Copyright": "© 2012 Hotel Sol S.A."
                              },
                              "Descriptions": {
                                "en-US": "Outdoor pool with sun loungers at dusk.",
                                "de-DE": "Außenpool mit Sonnenliegen in der Abenddämmerung."
                              },
                              "Compliance": {
                                "AIGenerated": true
                              },
                              "Presence": [
                                {
                                  "Label": "adult",
                                  "Confidence": 0.81
                                },
                                {
                                  "Label": "child",
                                  "Confidence": null
                                }
                              ],
                              "Safety": {
                                "Inappropriate": 0.02,
                                "OffTopic": null
                              },
                              "TextDetections": [
                                {
                                  "Content": "POOL BAR",
                                  "Label": "signage",
                                  "Confidence": 0.76
                                }
                              ],
                              "FeatureDetections": [
                                {
                                  "Label": "outdoor_pool",
                                  "Confidence": 0.97
                                },
                                {
                                  "Label": "sun_loungers",
                                  "Confidence": 0.83
                                }
                              ]
                            }
                          }
                        ]
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/getVisionImages_BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/getVisionImages_Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/getVisionImages_Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/getVisionImages_NotFound"
          },
          "429": {
            "$ref": "#/components/responses/getVisionImages_TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/getVisionImages_InternalServerError"
          }
        }
      }
    },
    "/v2/project/content/vision/ingestImages": {
      "post": {
        "summary": "Ingest vision images",
        "description": "Submit image URLs for analysis; each gets an image ID immediately.\n\nAsynchronous: poll the IDs with `getVisionImages` until `completed` or `failed`.\n\n- 1-100 images per request, each `URL` absolute `https`.\n- At most one selector (`HotelID`, `GlobalHotelID` or `ExternalHotelID`), or none; `HotelName` required with one, refused without.\n- Except `giata` alone, a selector reaches only your project's hotels, your placeholder hotel (no selector, or its HotelID) and draft hotels holding images you submitted and have not deleted. Any other hotel answers like an unknown one: 404, as does a project without Vision AI.\n- Only `giata` alone can create a hotel.\n- 429: daily cap reached (25,000 images or 1,000 new hotels per rolling 24 hours); wait `Retry-After` seconds.",
        "operationId": "ingestVisionImages",
        "tags": [
          "Content Enrichment API/Vision AI"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Project-ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IngestVisionImagesRequest"
              },
              "examples": {
                "withoutHotel": {
                  "summary": "Two images submitted without a hotel",
                  "value": {
                    "Images": [
                      {
                        "URL": "https://ucarecdn.com/9c1b7e42-5a6d-4f38-9a11-2b7c8d5e6f01/"
                      },
                      {
                        "URL": "https://ucarecdn.com/3f0a1d55-8b2c-4e79-9d64-7a1c2b3d4e5f/"
                      }
                    ]
                  }
                },
                "singleImage": {
                  "summary": "One image for a hotel identified by your own product code",
                  "value": {
                    "ExternalHotelID": {
                      "productid": "IBS-MAJ-4711"
                    },
                    "HotelName": "Hotel Bahia Azul",
                    "Images": [
                      {
                        "URL": "https://images.example-client.com/1234567/exterior-pool.jpg"
                      }
                    ]
                  }
                },
                "batchWithRoomRefs": {
                  "summary": "Three images for a known hotel selected by its UUID, two carrying the client's room codes",
                  "value": {
                    "HotelID": "0192fb17-5dc6-7abc-8def-123456789abc",
                    "HotelName": "Hotel Bahia Azul",
                    "Images": [
                      {
                        "URL": "https://images.example-client.com/1234567/lobby.jpg"
                      },
                      {
                        "URL": "https://images.example-client.com/1234567/room-dbl-sea-1.jpg",
                        "RoomRef": "DBL-SEA"
                      },
                      {
                        "URL": "https://images.example-client.com/1234567/room-suite-1.jpg",
                        "RoomRef": "SUITE-1"
                      }
                    ]
                  }
                },
                "resubmission": {
                  "summary": "Re-submitting two already known URLs alongside a new one",
                  "value": {
                    "ExternalHotelID": {
                      "productid": "IBS-MAJ-4711"
                    },
                    "HotelName": "Hotel Bahia Azul",
                    "Images": [
                      {
                        "URL": "https://images.example-client.com/1234567/lobby.jpg"
                      },
                      {
                        "URL": "https://images.example-client.com/1234567/restaurant.jpg"
                      },
                      {
                        "URL": "https://images.example-client.com/1234567/spa-old.jpg"
                      }
                    ]
                  }
                },
                "createByGiata": {
                  "summary": "Creating a hotel record: giata alone, not yet known",
                  "value": {
                    "ExternalHotelID": {
                      "giata": "1234567"
                    },
                    "HotelName": "Hotel Bahia Azul",
                    "Images": [
                      {
                        "URL": "https://images.example-client.com/1234567/exterior-pool.jpg"
                      }
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Images accepted. Every submitted URL has an image ID; analysis runs asynchronously, so poll the returned IDs with getVisionImages.",
            "headers": {
              "X-Trace-ID": {
                "$ref": "#/components/headers/X-Trace-ID"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IngestVisionImagesResponse"
                },
                "examples": {
                  "withoutHotel": {
                    "summary": "Both images are queued for analysis on the project's placeholder hotel",
                    "value": {
                      "Data": {
                        "HotelID": "01a086e1-ffaf-7040-b032-76677278f0ae",
                        "Images": [
                          {
                            "ImageID": "0199b2d0-11a5-7c5e-8f21-6d0e4f88b521",
                            "URL": "https://ucarecdn.com/9c1b7e42-5a6d-4f38-9a11-2b7c8d5e6f01/",
                            "Status": "pending"
                          },
                          {
                            "ImageID": "0199b2c4-8e31-77aa-9c02-3f5b71a2d9e4",
                            "URL": "https://ucarecdn.com/3f0a1d55-8b2c-4e79-9d64-7a1c2b3d4e5f/",
                            "Status": "pending"
                          }
                        ]
                      }
                    }
                  },
                  "singleImage": {
                    "summary": "The product code resolved to a known hotel and the image is queued for analysis",
                    "value": {
                      "Data": {
                        "HotelID": "0192fb17-5dc6-7abc-8def-123456789abc",
                        "Images": [
                          {
                            "ImageID": "0192fb20-1aa2-7def-9abc-1122334455aa",
                            "URL": "https://images.example-client.com/1234567/exterior-pool.jpg",
                            "Status": "pending"
                          }
                        ]
                      }
                    }
                  },
                  "batchWithRoomRefs": {
                    "summary": "Three new images attached to the hotel that already existed",
                    "value": {
                      "Data": {
                        "HotelID": "0192fb17-5dc6-7abc-8def-123456789abc",
                        "Images": [
                          {
                            "ImageID": "0192fb21-2bb3-7def-9abc-2233445566bb",
                            "URL": "https://images.example-client.com/1234567/lobby.jpg",
                            "Status": "pending"
                          },
                          {
                            "ImageID": "0192fb22-3cc4-7def-9abc-3344556677cc",
                            "URL": "https://images.example-client.com/1234567/room-dbl-sea-1.jpg",
                            "Status": "pending"
                          },
                          {
                            "ImageID": "0192fb23-4dd5-7def-9abc-4455667788dd",
                            "URL": "https://images.example-client.com/1234567/room-suite-1.jpg",
                            "Status": "pending"
                          }
                        ]
                      }
                    }
                  },
                  "resubmission": {
                    "summary": "One known URL is already analyzed, the other was confirmed unreachable earlier, and the new URL is queued",
                    "value": {
                      "Data": {
                        "HotelID": "0192fb17-5dc6-7abc-8def-123456789abc",
                        "Images": [
                          {
                            "ImageID": "0192fb21-2bb3-7def-9abc-2233445566bb",
                            "URL": "https://images.example-client.com/1234567/lobby.jpg",
                            "Status": "completed"
                          },
                          {
                            "ImageID": "0192fb24-5ee6-7def-9abc-5566778899ee",
                            "URL": "https://images.example-client.com/1234567/restaurant.jpg",
                            "Status": "pending"
                          },
                          {
                            "ImageID": "0192fb25-6ff7-7def-9abc-66778899aabb",
                            "URL": "https://images.example-client.com/1234567/spa-old.jpg",
                            "Status": "failed"
                          }
                        ]
                      }
                    }
                  },
                  "createByGiata": {
                    "summary": "A hotel record was created for the GIATA ID and the image is queued for analysis",
                    "value": {
                      "Data": {
                        "HotelID": "0192fb17-5dc6-7abc-8def-123456789abc",
                        "Images": [
                          {
                            "ImageID": "0192fb20-1aa2-7def-9abc-1122334455aa",
                            "URL": "https://images.example-client.com/1234567/exterior-pool.jpg",
                            "Status": "pending"
                          }
                        ]
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ingestVisionImages_BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/ingestVisionImages_Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/ingestVisionImages_Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/ingestVisionImages_NotFound"
          },
          "409": {
            "$ref": "#/components/responses/ingestVisionImages_Conflict"
          },
          "429": {
            "$ref": "#/components/responses/ingestVisionImages_TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/ingestVisionImages_InternalServerError"
          }
        }
      }
    },
    "/v2/project/content/vision/listImages": {
      "post": {
        "summary": "List vision images",
        "description": "List this project's submitted images, newest first, with the enriched image object for every image that is complete.\n\nAnalysis runs asynchronously, so an image listed as `pending` is still being worked on. An empty body `{}` returns the first page of everything this project has submitted.\n\n- `Limit` defaults to 50, caps at 100; `Offset` defaults to 0.\n- `Status` filters to `pending`, `completed` or `failed`; any other value returns 400.\n- Ordered by `SubmittedAt` then `ImageID`, both descending.\n- `Data` is the array itself; `Pagination.Total` counts the match.\n- A `Status` filter covers your newest 10,000 submissions.\n- 404 means Vision AI is not enabled for your project.\n- 429 means the rate limit was hit; wait `Retry-After` seconds.",
        "operationId": "listVisionImages",
        "tags": [
          "Content Enrichment API/Vision AI"
        ],
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/X-Project-ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ListVisionImagesRequest"
              },
              "examples": {
                "noFilter": {
                  "summary": "First page of everything this project has submitted",
                  "value": {}
                },
                "completedOnly": {
                  "summary": "Only the analyzed images, two per page",
                  "value": {
                    "Status": "completed",
                    "Limit": 2,
                    "Offset": 0
                  }
                },
                "pastTheEnd": {
                  "summary": "An offset beyond the last entry",
                  "value": {
                    "Offset": 200
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "One page of this project's submitted images, newest first.",
            "headers": {
              "X-Trace-ID": {
                "$ref": "#/components/headers/X-Trace-ID"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ListVisionImagesResponse"
                },
                "examples": {
                  "noFilter": {
                    "summary": "Four images: one still being analyzed, two analyzed, one unreachable — three submitted without a hotel and one for a hotel",
                    "value": {
                      "Data": [
                        {
                          "ImageID": "0199b2d0-11a5-7c5e-8f21-6d0e4f88b521",
                          "URL": "https://ucarecdn.com/9c1b7e42-5a6d-4f38-9a11-2b7c8d5e6f01/",
                          "Status": "pending",
                          "SubmittedAt": "2026-09-09T16:04:51.812433Z",
                          "BatchID": "0199b2d0-11a4-7c5e-8f21-5c9d3e77a410",
                          "HotelID": "01a086e1-ffaf-7040-b032-76677278f0ae",
                          "HotelName": "Vision AI API placeholder",
                          "IsPlaceholderHotel": true
                        },
                        {
                          "ImageID": "0199b2c4-8e31-77aa-9c02-3f5b71a2d9e4",
                          "URL": "https://ucarecdn.com/3f0a1d55-8b2c-4e79-9d64-7a1c2b3d4e5f/",
                          "Status": "completed",
                          "SubmittedAt": "2026-09-09T16:04:12.550118Z",
                          "BatchID": "0199b2c4-8e30-7b19-9a4d-2e7f6c1b8d33",
                          "HotelID": "01a086e1-ffaf-7040-b032-76677278f0ae",
                          "HotelName": "Vision AI API placeholder",
                          "IsPlaceholderHotel": true,
                          "Image": {
                            "ID": "0199b2c4-8e31-77aa-9c02-3f5b71a2d9e4",
                            "URL": "https://ucarecdn.com/3f0a1d55-8b2c-4e79-9d64-7a1c2b3d4e5f/",
                            "Source": "photo",
                            "Category": "restaurant",
                            "Features": [
                              "indoor_seating",
                              "buffet"
                            ],
                            "Mood": [
                              "warm",
                              "inviting"
                            ],
                            "Tags": [
                              "breakfast"
                            ],
                            "AppealScore": 74,
                            "QualityScore": 81,
                            "AppealScoreVersion": "app-v4",
                            "QualityScoreVersion": "qs-v4",
                            "Width": 2000,
                            "Height": 1333,
                            "Format": "jpeg",
                            "FileSize": 611000,
                            "DominantColor": "#8A6A48",
                            "BlurHash": "L6PZfSjE.AyE_3t7t7R**0o#DgR4",
                            "FileMetadata": {
                              "CaptureDate": "2012-06-14",
                              "Copyright": "© 2012 Hotel Sol S.A."
                            },
                            "Descriptions": {
                              "en-US": "Restaurant with buffet counters and set tables.",
                              "de-DE": "Restaurant mit Buffettheken und eingedeckten Tischen."
                            },
                            "Compliance": {
                              "AIGenerated": true
                            },
                            "FeatureDetections": [
                              {
                                "Label": "buffet",
                                "Confidence": 0.91
                              },
                              {
                                "Label": "indoor_seating",
                                "Confidence": 0.86
                              }
                            ]
                          }
                        },
                        {
                          "ImageID": "0199b2c4-8e31-77aa-9c02-1a4c60b8c7f1",
                          "URL": "https://ucarecdn.com/7d4e9b21-6c3a-4f52-8e10-9b8a7c6d5e4f/",
                          "Status": "failed",
                          "SubmittedAt": "2026-09-09T16:04:12.550118Z",
                          "BatchID": "0199b2c4-8e30-7b19-9a4d-2e7f6c1b8d33",
                          "HotelID": "01a086e1-ffaf-7040-b032-76677278f0ae",
                          "HotelName": "Vision AI API placeholder",
                          "IsPlaceholderHotel": true
                        },
                        {
                          "ImageID": "0199a51f-4c23-7de8-b3a9-1122334455aa",
                          "URL": "https://images.example-client.com/1234567/room-dbl-sea-1.jpg",
                          "Status": "completed",
                          "SubmittedAt": "2026-09-08T09:12:44.301882Z",
                          "BatchID": "0199a51f-4c22-7de8-b3a9-0f1e2d3c4b5a",
                          "HotelID": "0192fb17-5dc6-7abc-8def-123456789abc",
                          "HotelName": "Hotel Bahia Azul",
                          "RoomRef": "DBL-SEA",
                          "Image": {
                            "ID": "0199a51f-4c23-7de8-b3a9-1122334455aa",
                            "URL": "https://images.example-client.com/1234567/room-dbl-sea-1.jpg",
                            "Source": "photo",
                            "Category": "room",
                            "Features": [
                              "sea_view",
                              "balcony",
                              "double_bed"
                            ],
                            "Mood": [
                              "bright",
                              "calm"
                            ],
                            "Tags": [
                              "sea_view"
                            ],
                            "AppealScore": 82,
                            "QualityScore": 77,
                            "AppealScoreVersion": "app-v4",
                            "QualityScoreVersion": "qs-v4",
                            "Width": 1600,
                            "Height": 1067,
                            "Format": "jpeg",
                            "FileSize": 412000,
                            "DominantColor": "#2E6F95",
                            "BlurHash": "LEHV6nWB2yk8pyo0adR*",
                            "Descriptions": {
                              "en-US": "Double room with a balcony overlooking the sea.",
                              "de-DE": "Doppelzimmer mit Balkon und Meerblick."
                            },
                            "Compliance": {
                              "AIGenerated": true
                            },
                            "Presence": [
                              {
                                "Label": "adult",
                                "Confidence": 0.81
                              }
                            ],
                            "Safety": {
                              "Inappropriate": 0.02,
                              "OffTopic": null
                            },
                            "FeatureDetections": [
                              {
                                "Label": "sea_view",
                                "Confidence": 0.94
                              },
                              {
                                "Label": "balcony",
                                "Confidence": 0.88
                              }
                            ]
                          }
                        }
                      ],
                      "Pagination": {
                        "Total": 4,
                        "Limit": 50,
                        "Offset": 0
                      }
                    }
                  },
                  "completedOnly": {
                    "summary": "The two analyzed images, one page of two, and Total counts only what the filter matched",
                    "value": {
                      "Data": [
                        {
                          "ImageID": "0199b2c4-8e31-77aa-9c02-3f5b71a2d9e4",
                          "URL": "https://ucarecdn.com/3f0a1d55-8b2c-4e79-9d64-7a1c2b3d4e5f/",
                          "Status": "completed",
                          "SubmittedAt": "2026-09-09T16:04:12.550118Z",
                          "BatchID": "0199b2c4-8e30-7b19-9a4d-2e7f6c1b8d33",
                          "HotelID": "01a086e1-ffaf-7040-b032-76677278f0ae",
                          "HotelName": "Vision AI API placeholder",
                          "IsPlaceholderHotel": true,
                          "Image": {
                            "ID": "0199b2c4-8e31-77aa-9c02-3f5b71a2d9e4",
                            "URL": "https://ucarecdn.com/3f0a1d55-8b2c-4e79-9d64-7a1c2b3d4e5f/",
                            "Source": "photo",
                            "Category": "restaurant",
                            "Features": [
                              "indoor_seating",
                              "buffet"
                            ],
                            "Mood": [
                              "warm",
                              "inviting"
                            ],
                            "Tags": [
                              "breakfast"
                            ],
                            "AppealScore": 74,
                            "QualityScore": 81,
                            "AppealScoreVersion": "app-v4",
                            "QualityScoreVersion": "qs-v4",
                            "Width": 2000,
                            "Height": 1333,
                            "Format": "jpeg",
                            "FileSize": 611000,
                            "DominantColor": "#8A6A48",
                            "BlurHash": "L6PZfSjE.AyE_3t7t7R**0o#DgR4",
                            "Descriptions": {
                              "en-US": "Restaurant with buffet counters and set tables.",
                              "de-DE": "Restaurant mit Buffettheken und eingedeckten Tischen."
                            },
                            "Compliance": {
                              "AIGenerated": true
                            }
                          }
                        },
                        {
                          "ImageID": "0199a51f-4c23-7de8-b3a9-1122334455aa",
                          "URL": "https://images.example-client.com/1234567/room-dbl-sea-1.jpg",
                          "Status": "completed",
                          "SubmittedAt": "2026-09-08T09:12:44.301882Z",
                          "BatchID": "0199a51f-4c22-7de8-b3a9-0f1e2d3c4b5a",
                          "HotelID": "0192fb17-5dc6-7abc-8def-123456789abc",
                          "HotelName": "Hotel Bahia Azul",
                          "RoomRef": "DBL-SEA",
                          "Image": {
                            "ID": "0199a51f-4c23-7de8-b3a9-1122334455aa",
                            "URL": "https://images.example-client.com/1234567/room-dbl-sea-1.jpg",
                            "Source": "photo",
                            "Category": "room",
                            "Features": [
                              "sea_view",
                              "balcony",
                              "double_bed"
                            ],
                            "Mood": [
                              "bright",
                              "calm"
                            ],
                            "Tags": [
                              "sea_view"
                            ],
                            "AppealScore": 82,
                            "QualityScore": 77,
                            "AppealScoreVersion": "app-v4",
                            "QualityScoreVersion": "qs-v4",
                            "Width": 1600,
                            "Height": 1067,
                            "Format": "jpeg",
                            "FileSize": 412000,
                            "DominantColor": "#2E6F95",
                            "BlurHash": "LEHV6nWB2yk8pyo0adR*",
                            "Descriptions": {
                              "en-US": "Double room with a balcony overlooking the sea.",
                              "de-DE": "Doppelzimmer mit Balkon und Meerblick."
                            },
                            "Compliance": {
                              "AIGenerated": true
                            }
                          }
                        }
                      ],
                      "Pagination": {
                        "Total": 2,
                        "Limit": 2,
                        "Offset": 0
                      }
                    }
                  },
                  "pastTheEnd": {
                    "summary": "An empty page: Images is [], and Total still counts every match",
                    "value": {
                      "Data": [],
                      "Pagination": {
                        "Total": 4,
                        "Limit": 50,
                        "Offset": 200
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/listVisionImages_BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/listVisionImages_Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/listVisionImages_Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/listVisionImages_NotFound"
          },
          "429": {
            "$ref": "#/components/responses/listVisionImages_TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/listVisionImages_InternalServerError"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "AcceptApprovalImageUploadRequest": {
        "type": "object",
        "required": [
          "HotelID",
          "FeedbackID"
        ],
        "description": "The upload to accept and its hotel.",
        "properties": {
          "HotelID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the hotel. Required, a valid non-nil UUID, and a live member of the calling project.",
            "example": "019d9c2e-0ef8-7458-b0fa-8bed7182eb30"
          },
          "FeedbackID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the upload: its `ID` from listApprovalImageUploads, the id of its feedback item. Required, a valid non-nil UUID.",
            "example": "01a0f1c9-3e8a-7c12-b4d5-8e9f0a1b2c3d"
          }
        }
      },
      "AcceptApprovalImageUploadResponse": {
        "type": "object",
        "required": [
          "Data"
        ],
        "description": "Single-object response envelope wrapping the decided upload.",
        "properties": {
          "Data": {
            "$ref": "#/components/schemas/ApprovalImageUpload"
          }
        }
      },
      "AddTagToHotelsRequest": {
        "type": "object",
        "required": [
          "TagID",
          "HotelIDs"
        ],
        "description": "Request body for bulk-adding a tag to hotels.",
        "properties": {
          "TagID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the project tag to apply. Must be a valid, non-nil UUID belonging to the calling project; a foreign tag returns 404.",
            "example": "0192fc01-1111-7abc-8def-aaaaaaaaaaaa"
          },
          "HotelIDs": {
            "type": "array",
            "minItems": 1,
            "maxItems": 1000,
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "Hotel UUIDs to tag. Must contain between 1 and 1000 ids. Each id is validated and membership-checked individually; a malformed id is reported 'invalid' in the per-hotel results rather than failing the whole request.",
            "example": [
              "0192fb17-5dc6-7abc-8def-123456789abc",
              "0192fb18-6ed7-7abc-8def-223456789abc"
            ]
          }
        }
      },
      "AddTagToHotelsResponse": {
        "type": "object",
        "required": [
          "Data"
        ],
        "description": "Single-object response envelope wrapping the bulk add outcome.",
        "properties": {
          "Data": {
            "$ref": "#/components/schemas/BulkTagResult"
          }
        }
      },
      "Address": {
        "type": "object",
        "description": "Postal address and contact details extracted from enrichment details. Present only when address data is available.",
        "properties": {
          "Street": {
            "type": "string",
            "description": "Street name and number.",
            "example": "Carrer de la Mar 12"
          },
          "City": {
            "type": "string",
            "description": "City or town.",
            "example": "Palma"
          },
          "CityNames": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Localized city display names keyed by BCP 47 language tag, present only when they have been generated. Fall back to `City`.",
            "example": {
              "en-US": "Rome",
              "de-DE": "Rom",
              "it-IT": "Roma"
            }
          },
          "State": {
            "type": "string",
            "description": "State, province, or region.",
            "example": "Illes Balears"
          },
          "PostalCode": {
            "type": "string",
            "description": "Postal or ZIP code.",
            "example": "07015"
          },
          "Phone": {
            "type": "string",
            "description": "The hotel's phone number, as its sources state it. Omitted when none is known.",
            "example": "+34 971 000 000"
          },
          "Email": {
            "type": "string",
            "description": "The hotel's email address, as its sources state it. Omitted when none is known.",
            "example": "info@bahia-azul.example"
          }
        }
      },
      "ApprovalApprover": {
        "type": "object",
        "required": [
          "Name"
        ],
        "properties": {
          "Name": {
            "type": "string",
            "description": "The contact's name.",
            "example": "Ayşe Yılmaz"
          },
          "Email": {
            "type": "string",
            "format": "email",
            "description": "The contact's email address.",
            "example": "ayse@sotavento.example"
          },
          "Phone": {
            "type": "string",
            "description": "The contact's phone number. Omitted when the contact did not supply one.",
            "example": "+34 928 000 000"
          }
        }
      },
      "ApprovalImageUpload": {
        "type": "object",
        "required": [
          "ID",
          "HotelID",
          "URL",
          "Width",
          "Height",
          "FileSize",
          "Format",
          "Status",
          "CreatedAt"
        ],
        "description": "One photo a hotel contact uploaded on the approval page.",
        "properties": {
          "ID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the upload: the id of its feedback item. Pass it as `FeedbackID` to acceptApprovalImageUpload or rejectApprovalImageUpload.",
            "example": "01a0f1c9-3e8a-7c12-b4d5-8e9f0a1b2c3d"
          },
          "HotelID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the hotel the photo was uploaded for.",
            "example": "019d9c2e-0ef8-7458-b0fa-8bed7182eb30"
          },
          "URL": {
            "type": "string",
            "format": "uri",
            "description": "Where the photo is served from.",
            "example": "https://ucarecdn.com/8f14e45f-ceea-467a-9575-7d3b1c2a9e10/"
          },
          "Width": {
            "type": "integer",
            "description": "Width of the photo in pixels: for a photo recorded as uploaded (uploadImage names its Uploadcare URL), the width the hotel's browser reported (YGO-4317), unverified; 0 when none was sent. Uploads recorded before YGO-4286 (multipart) carry the stored photo's width.",
            "example": 1600
          },
          "Height": {
            "type": "integer",
            "description": "Height of the photo in pixels: for a photo recorded as uploaded (uploadImage names its Uploadcare URL), the height the hotel's browser reported (YGO-4317), unverified; 0 when none was sent. Uploads recorded before YGO-4286 (multipart) carry the stored photo's height.",
            "example": 1200
          },
          "FileSize": {
            "type": "integer",
            "description": "Size of the photo's file in bytes: 0 for a photo recorded as uploaded (uploadImage names its Uploadcare URL), whose size is not read. Uploads recorded before YGO-4286 (multipart) carry the stored photo's file size.",
            "example": 0
          },
          "Format": {
            "type": "string",
            "enum": [
              "jpeg",
              "png",
              ""
            ],
            "description": "File type of the photo: empty for a photo recorded as uploaded (uploadImage names its Uploadcare URL), whose type is not read. Uploads recorded before YGO-4286 (multipart) carry `jpeg` or `png`.",
            "example": ""
          },
          "Status": {
            "type": "string",
            "enum": [
              "pending",
              "accepted",
              "rejected"
            ],
            "description": "State of the upload: `pending` until a reviewer decides, `accepted` once it is on the page's photo list, `rejected` when it was refused and is never served.",
            "example": "pending"
          },
          "CreatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "When the photo was uploaded (RFC3339).",
            "example": "2026-10-12T09:14:03.512874Z"
          },
          "ReviewedAt": {
            "type": "string",
            "format": "date-time",
            "description": "When a reviewer accepted or rejected the upload (RFC3339). Omitted while it is pending.",
            "example": "2026-10-12T11:02:39.660142Z"
          }
        }
      },
      "ApprovalImageUploadList": {
        "type": "object",
        "required": [
          "Uploads"
        ],
        "description": "The hotel's photo uploads.",
        "properties": {
          "Uploads": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ApprovalImageUpload"
            },
            "description": "The uploads in every state but withdrawn, newest first, at most 200. Always present; empty when the hotel has none."
          }
        }
      },
      "ApprovalLink": {
        "type": "object",
        "required": [
          "HotelID",
          "HotelName",
          "Token",
          "TokenPreview",
          "Status",
          "Created",
          "CreatedAt",
          "UpdatedAt"
        ],
        "description": "One hotel's approval link and its state. The same shape is returned by createApprovalLinks and rotateApprovalLink; revokeApprovalLink returns it without `Token` (the link is dead), and `listApprovals` returns it minus `Token`, which that endpoint deliberately omits (contract A10.1).",
        "properties": {
          "HotelID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the hotel this link belongs to.",
            "example": "019d9c2e-0ef8-7458-b0fa-8bed7182eb30"
          },
          "HotelName": {
            "type": "string",
            "description": "Display name of the hotel.",
            "example": "Sotavento Beach Club"
          },
          "GiataID": {
            "type": "integer",
            "description": "The hotel's GIATA id. Omitted when the hotel has none.",
            "example": 5721
          },
          "MasterCode": {
            "type": "string",
            "description": "The calling project's master code for this hotel. Omitted when the project has no code for it.",
            "example": "FUED0009"
          },
          "Token": {
            "type": "string",
            "minLength": 43,
            "maxLength": 43,
            "description": "The 43-character link token — the full credential of the hotel's approval page. Build the link from it; do not log or display it.",
            "example": "xPBOjXHomqBvKZ0nQ2sT7yWlR4dGuAeIcNvXbF9pMk3"
          },
          "TokenPreview": {
            "type": "string",
            "description": "Display form of the token: its first 8 characters followed by an ellipsis. Never enough to reconstruct the link.",
            "example": "xPBOjXHo..."
          },
          "Status": {
            "type": "string",
            "enum": [
              "waiting_for_hotel",
              "feedback_received",
              "feedback_applied",
              "approved"
            ],
            "description": "Approval state of this hotel's link. `waiting_for_hotel` on creation; any feedback moves it to `feedback_received`; `feedback_applied` is set once the feedback has been worked in; `approved` is never left by a later feedback submission; the one way back to `waiting_for_hotel` is a re-minted link (createApprovalLinks after a revoke), which keeps ApprovedAt, ApprovedTextGeneratedAt and ApprovedBy as the record of the earlier approval.",
            "example": "waiting_for_hotel"
          },
          "ApprovedAt": {
            "type": "string",
            "format": "date-time",
            "description": "When the hotel approved (RFC3339). Present once the hotel has ever approved: it is the RECORD of that approval and survives a later revoke and a re-minted link, so it can accompany a `waiting_for_hotel` Status (see createApprovalLinks). Only a fresh approval replaces it.",
            "example": "2026-08-25T18:19:18.860882Z"
          },
          "ApprovedTextGeneratedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Newest generation timestamp across the texts that were approved (RFC3339). Compare it with the hotel's current texts to see whether they changed since the approval. Present once the hotel has ever approved (it survives a revoke and a re-minted link, like ApprovedAt), and omitted then if none of the approved texts carried a timestamp.",
            "example": "2026-08-19T14:14:57.674681Z"
          },
          "ApprovedBy": {
            "allOf": [
              {
                "$ref": "#/components/schemas/ApprovalApprover"
              }
            ],
            "description": "Present once the hotel has ever approved: the record of who signed off, kept across a later revoke and a re-minted link (so it can accompany a `waiting_for_hotel` Status) and replaced only by a fresh approval. The identity is the snapshot taken at approval time and survives deletion of the contact record (`approved_by` is `ON DELETE SET NULL`; the snapshot columns are not cleared)."
          },
          "LastOpenedAt": {
            "type": "string",
            "format": "date-time",
            "description": "When the approval page was last loaded (RFC3339). Omitted while the link has never been opened.",
            "example": "2026-08-25T18:19:18.966928Z"
          },
          "RevokedAt": {
            "type": "string",
            "format": "date-time",
            "description": "When the link was revoked (RFC3339). Omitted while the link is live. A link carrying it is never returned with a `Token`.",
            "example": "2026-08-25T18:19:19.602402Z"
          },
          "Created": {
            "type": "boolean",
            "description": "`true` only when this call minted the credential in `Token`: a brand-new link, or a fresh one for a hotel whose link had been revoked. `false` for a hotel that already had a live link, and always `false` on rotateApprovalLink, revokeApprovalLink and listApprovals.",
            "example": true
          },
          "CreatedBy": {
            "type": "string",
            "description": "Audit identity of who minted the link: a user token records the user's email; a project API key records its project-scoped identity (`project:<project-uuid>`). That is what is STORED; what is RETURNED is gated. The stored identity is an operator identity by construction, so in practice it carries an internal staff email — a contact route, and therefore contact PII on the same footing as `ApprovedBy.Email` and `ApprovedBy.Phone`: it is returned only to a caller presenting a user_ token, and is omitted entirely for a proj_ project token (the key is absent, not an empty string).",
            "example": "editor@example.com"
          },
          "CreatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "When the link was minted (RFC3339).",
            "example": "2026-08-25T18:19:17.522006Z"
          },
          "UpdatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "When the link row was last touched (RFC3339). The `updated_at` trigger fires on every update, so this moves on a status transition, an approval and a token rotation — and also when the hotel merely opens the page, because that stamps `last_opened_at`. Do not use it to detect approval-state changes.",
            "example": "2026-08-25T18:19:17.522006Z"
          }
        }
      },
      "ApprovedHotelTextFile": {
        "type": "string",
        "description": "The file body: UTF-8 with LF line endings. A framed metadata block (`Hotel`, `GIATA`, `ProductID`, `Locale`, `Approved`, `Text version`, `Images`, and the always-present `AI notice` disclosure), then the approved texts between `--- BEGIN APPROVED TEXT ---` and `--- END APPROVED TEXT ---`, each introduced by its template key in brackets, then the image URLs the approval page shows (the page's own selection — the operator's ordered image list when the project holds one for the hotel, otherwise at most ten chosen by the approval image rule; both documented on the `Images` property of `getApprovalLink`) between `--- BEGIN IMAGE URLS (in the order the approval page serves them) ---` and `--- END IMAGE URLS ---`, numbered, one per line, in the page's order.",
        "example": "==================================================================\n APPROVED CATALOG TEXT - METADATA (not part of the text, do not paste)\n Hotel:         Neptune Luxury Resort\n GIATA:         741\n ProductID:     NEP-KOS-01\n Locale:        de-DE\n Approved:      2026-08-27T13:50:10Z by Ayşe Yılmaz\n Text version:  2026-08-19T14:15:29Z\n Images:        3\n AI notice:     This text is AI-generated (EU AI Act Art. 50(2))\n==================================================================\n--- BEGIN APPROVED TEXT ---\n\n[Summary]\nNeptune Luxury Resort ist ein **5-Sterne-Resort in Familienbesitz direkt am Strand**, das sich in Mastichari auf der Insel Kos befindet. Die 1989 gegründete Unterkunft liegt inmitten weitläufig angelegter Themengärten direkt an einem privaten, abgelegenen Sandstrand.\n\n[Highlights]\n- Privater Sandstrand in ruhiger Lage\n- Weitläufig angelegte Themengärten\n- Außergewöhnliche Sauberkeit in der gesamten Anlage\n\n[GuestPolicies]\nCheck-in ab 15:00 Uhr, Check-out bis 11:00 Uhr. Haustiere sind nicht gestattet.\n\n--- END APPROVED TEXT ---\n\n--- BEGIN IMAGE URLS (in the order the approval page serves them) ---\n1. https://images.ygo.ai/hotels/019f412f-c41c-746e-b569-e6454677366c/3f9a2c7e.jpg\n2. https://images.ygo.ai/hotels/019f412f-c41c-746e-b569-e6454677366c/b71d04e2.jpg\n3. https://images.ygo.ai/hotels/019f412f-c41c-746e-b569-e6454677366c/9c4e61aa.jpg\n--- END IMAGE URLS ---\n"
      },
      "Bedding": {
        "type": "object",
        "required": [
          "Type",
          "Quantity"
        ],
        "description": "A single bed entry within a bedding configuration.",
        "properties": {
          "Type": {
            "type": "string",
            "description": "Bed type. Known codes: SINGLE, TWIN, DOUBLE, QUEEN, KING, SOFA_BED, BUNK_BED, EXTRA_BED, CRIB, CHILD_BED, DAY_BED, MURPHY_BED, CHAIR_BED; older records can hold other values.",
            "example": "DOUBLE"
          },
          "Quantity": {
            "type": "integer",
            "description": "Number of beds of this type.",
            "example": 1
          },
          "Name": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Bed type name per room Name locale (BCP 47) in en, de, fr, it, nl, es, tr or he, shown after Quantity: singular for 1, else the counted form, plural if inflected. Absent for an unknown Type or no such locale; use Type.",
            "example": {
              "en-US": "double bed",
              "de-DE": "Doppelbett"
            }
          }
        }
      },
      "BulkTagHotelResult": {
        "type": "object",
        "required": [
          "HotelID",
          "Status"
        ],
        "description": "The outcome for one hotel in a bulk add.",
        "properties": {
          "HotelID": {
            "type": "string",
            "description": "The hotel id from the request (echoed verbatim, so an invalid id appears as submitted).",
            "example": "0192fb17-5dc6-7abc-8def-123456789abc"
          },
          "Status": {
            "type": "string",
            "enum": [
              "applied",
              "skipped_not_member",
              "invalid"
            ],
            "description": "Per-hotel outcome: 'applied' (a live project member, now tagged), 'skipped_not_member' (a valid id that is not a live member of the project; never tagged), or 'invalid' (a malformed / non-UUID id).",
            "example": "applied"
          }
        }
      },
      "BulkTagResult": {
        "type": "object",
        "required": [
          "TagID",
          "Results"
        ],
        "description": "The per-hotel outcomes of a bulk add.",
        "properties": {
          "TagID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the tag that was applied.",
            "example": "0192fc01-1111-7abc-8def-aaaaaaaaaaaa"
          },
          "Results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BulkTagHotelResult"
            },
            "description": "One entry per submitted hotel id, in submission order."
          }
        }
      },
      "CheckIn": {
        "type": "object",
        "description": "Earliest check-in time. The whole object is omitted when no valid time is available.",
        "properties": {
          "From": {
            "type": "string",
            "description": "Earliest check-in time as a 24-hour 'HH:MM' clock string.",
            "example": "15:00"
          }
        }
      },
      "CheckOut": {
        "type": "object",
        "description": "Latest check-out time. The whole object is omitted when no valid time is available.",
        "properties": {
          "Until": {
            "type": "string",
            "description": "Latest check-out time as a 24-hour 'HH:MM' clock string.",
            "example": "11:00"
          }
        }
      },
      "ClearedHotelImagePin": {
        "type": "object",
        "required": [
          "HotelID"
        ],
        "description": "The hotel whose pin was cleared.",
        "properties": {
          "HotelID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the hotel whose pin was cleared.",
            "example": "0192fb17-5dc6-7abc-8def-123456789abc"
          }
        }
      },
      "ClearedHotelStars": {
        "type": "object",
        "required": [
          "HotelID",
          "Cleared"
        ],
        "description": "The hotel whose grade was cleared.",
        "properties": {
          "HotelID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the hotel whose grade was cleared.",
            "example": "0192fb17-5dc6-7abc-8def-123456789abc"
          },
          "Cleared": {
            "type": "boolean",
            "description": "Always true on success, including when the hotel had no grade to clear.",
            "example": true
          }
        }
      },
      "Compliance": {
        "type": "object",
        "properties": {
          "AIGenerated": {
            "type": "boolean",
            "description": "EU AI Act Article 50(2) machine-readable marker: true when the text content of the enclosing object is AI-generated. Always stated explicitly when the envelope is present.",
            "example": true
          }
        }
      },
      "ContentSettings": {
        "type": "object",
        "required": [
          "Locales",
          "DefaultLocale"
        ],
        "description": "The project's content locale configuration.",
        "properties": {
          "Locales": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Enabled output locales as BCP 47 language tags. Empty when no locales are configured.",
            "example": [
              "en-US",
              "de-DE",
              "fr-FR"
            ]
          },
          "DefaultLocale": {
            "type": "string",
            "description": "Default output locale (BCP 47 language tag) used when a request does not specify one. Empty when no default is configured.",
            "example": "en-US"
          }
        }
      },
      "CreateApprovalLinksRequest": {
        "type": "object",
        "required": [
          "HotelIDs"
        ],
        "description": "The hotels to mint approval links for.",
        "properties": {
          "HotelIDs": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "minItems": 1,
            "maxItems": 500,
            "description": "UUIDs of the hotels to mint links for. Required, 1 to 500 entries, each a valid non-nil UUID. Duplicates are collapsed and the request order is preserved.",
            "example": [
              "019d9c2e-0ef8-7458-b0fa-8bed7182eb30",
              "019d9c23-1238-7334-bf02-4c45c50e033a"
            ]
          }
        }
      },
      "CreateApprovalLinksResponse": {
        "type": "object",
        "required": [
          "Data"
        ],
        "description": "List response envelope wrapping the links, plus the membership residue.",
        "properties": {
          "Data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ApprovalLink"
            },
            "description": "One entry per requested hotel that is a live member of the project, in request order. Always present, empty when no requested id was a member."
          },
          "NotInProjectIDs": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "Requested hotel ids that are not live members of the calling project and were therefore skipped. Omitted when every requested id was a member.",
            "example": [
              "019e4afb-e973-764c-9bb1-a4c66175e08b"
            ]
          }
        }
      },
      "DeleteHotelImagePinRequest": {
        "type": "object",
        "required": [
          "HotelID"
        ],
        "description": "Request body for clearing a hotel's pinned first image.",
        "properties": {
          "HotelID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the hotel whose pin to clear. Must be a valid, non-nil UUID. Clearing a hotel with no pin succeeds unchanged.",
            "example": "0192fb17-5dc6-7abc-8def-123456789abc"
          }
        }
      },
      "DeleteHotelImagePinResponse": {
        "type": "object",
        "required": [
          "Data"
        ],
        "description": "Single-object response envelope wrapping the cleared hotel's identity.",
        "properties": {
          "Data": {
            "$ref": "#/components/schemas/ClearedHotelImagePin"
          }
        }
      },
      "DeleteHotelStarsRequest": {
        "type": "object",
        "required": [
          "HotelID"
        ],
        "description": "Request body for clearing your project's star grade for a hotel.",
        "properties": {
          "HotelID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the hotel whose grade to clear. The hotel must belong to the calling project; a hotel outside the project's scope returns 404.",
            "example": "0192fb17-5dc6-7abc-8def-123456789abc"
          }
        }
      },
      "DeleteHotelStarsResponse": {
        "type": "object",
        "required": [
          "Data"
        ],
        "description": "Single-object response envelope wrapping the cleared hotel's identity.",
        "properties": {
          "Data": {
            "$ref": "#/components/schemas/ClearedHotelStars"
          }
        }
      },
      "DeleteTagRequest": {
        "type": "object",
        "required": [
          "TagID"
        ],
        "description": "Request body for deleting a project tag.",
        "properties": {
          "TagID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the tag to delete. Must be a valid, non-nil UUID belonging to the calling project; a tag id not in the project returns 404.",
            "example": "0192fc01-1111-7abc-8def-aaaaaaaaaaaa"
          }
        }
      },
      "DeleteTagResponse": {
        "type": "object",
        "required": [
          "Data"
        ],
        "description": "Single-object response envelope wrapping the deleted tag's identity.",
        "properties": {
          "Data": {
            "$ref": "#/components/schemas/DeletedProjectTag"
          }
        }
      },
      "DeleteVisionImagesRequest": {
        "type": "object",
        "required": [
          "ImageIDs"
        ],
        "description": "Request body for deleting images this project submitted, by image ID.",
        "properties": {
          "ImageIDs": {
            "type": "array",
            "minItems": 1,
            "maxItems": 100,
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "Image UUIDs returned by ingestVisionImages, between 1 and 100 per request. The response returns one entry per ID, in this order.",
            "example": [
              "0192fb20-1aa2-7def-9abc-1122334455aa",
              "0192fb21-2bb3-7def-9abc-2233445566bb"
            ]
          }
        }
      },
      "DeleteVisionImagesResponse": {
        "type": "object",
        "description": "Standard v2 envelope. Data is an object carrying the per-image results; there is no pagination on this endpoint.",
        "properties": {
          "Data": {
            "$ref": "#/components/schemas/DeleteVisionImagesResult"
          }
        }
      },
      "DeleteVisionImagesResult": {
        "type": "object",
        "required": [
          "Images"
        ],
        "properties": {
          "Images": {
            "type": "array",
            "description": "One entry per requested image ID, in request order.",
            "items": {
              "$ref": "#/components/schemas/DeletedVisionImageState"
            }
          }
        }
      },
      "DeletedProjectTag": {
        "type": "object",
        "required": [
          "ID",
          "ProjectID"
        ],
        "description": "The identity of the tag that was deleted.",
        "properties": {
          "ID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the deleted tag.",
            "example": "0192fc01-1111-7abc-8def-aaaaaaaaaaaa"
          },
          "ProjectID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the project the tag belonged to.",
            "example": "0192fa00-0000-7abc-8def-000000000000"
          }
        }
      },
      "DeletedVisionImageState": {
        "type": "object",
        "required": [
          "ImageID",
          "Status"
        ],
        "description": "The verdict for one requested image ID. The entry carries no other field in either case, so a not_found entry is indistinguishable in shape from a deleted one.",
        "properties": {
          "ImageID": {
            "type": "string",
            "format": "uuid",
            "description": "Echoes the requested image ID.",
            "example": "0192fb20-1aa2-7def-9abc-1122334455aa"
          },
          "Status": {
            "type": "string",
            "enum": [
              "deleted",
              "not_found"
            ],
            "description": "`deleted`: this project's image is now deleted, or already was. `not_found`: the ID is unknown, belongs to another client or is not a Vision AI image, and these cases are indistinguishable."
          }
        }
      },
      "DetectionConfidence": {
        "type": "number",
        "format": "float",
        "nullable": true,
        "minimum": 0,
        "maximum": 1,
        "description": "Confidence between 0 and 1, or null when the entry was asserted without a measured confidence. An entry the analysis did not assert is absent from its list rather than scored zero.",
        "example": 0.94
      },
      "EnrichedHotel": {
        "type": "object",
        "required": [
          "ID",
          "Name",
          "Names",
          "Stars",
          "StarsMap",
          "AccommodationType",
          "Location",
          "FactualAttributes",
          "POIs",
          "GeneratedTexts",
          "Images",
          "Rooms",
          "Status",
          "CreatedAt",
          "UpdatedAt"
        ],
        "description": "A fully enriched hotel with its identity, location, factual attributes, structured check-in / check-out times, per-locale generated texts, guest rating, images, and rooms.",
        "properties": {
          "ID": {
            "type": "string",
            "format": "uuid",
            "description": "Unique hotel UUID.",
            "example": "0192fb17-5dc6-7abc-8def-123456789abc"
          },
          "Name": {
            "type": "string",
            "description": "Normalized English (en-US) hotel display name.",
            "example": "Bahia Azul Beach Resort"
          },
          "Names": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Per-locale display names keyed by BCP 47 language tag, always including en-US. Other locales appear only when a localized name has been generated.",
            "example": {
              "en-US": "Bahia Azul Beach Resort",
              "de-DE": "Bahia Azul Strandresort"
            }
          },
          "ExternalHotelIDs": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "External identifiers this hotel is known by, omitted when it has none. Current keys are `ProductID`, `Giata` and `PeakworkGoalID`, each only when it applies; the map is open, so read the keys you need.",
            "example": {
              "ProductID": "HTL-MAJ-4711",
              "Giata": "668370",
              "PeakworkGoalID": "864521"
            }
          },
          "GlobalHotelID": {
            "type": "string",
            "description": "Cross-tenant global hotel identifier. Omitted when the hotel has no global ID assigned.",
            "example": "ES-MALLR-K7MP2"
          },
          "Stars": {
            "type": "number",
            "format": "float",
            "description": "The hotel's default star grade (StarsMap.default.Stars); 0 when unrated.",
            "example": 4
          },
          "StarsMap": {
            "$ref": "#/components/schemas/StarsMap"
          },
          "AccommodationType": {
            "type": "string",
            "description": "Accommodation kind, for example hotel, apartment, aparthotel, resort, villa, hostel, guesthouse, bed_and_breakfast, cruise_ship or holiday_village. The set of values may be extended, so read it as an open string.",
            "example": "hotel"
          },
          "Chain": {
            "type": "string",
            "description": "Hotel company the property belongs to. Omitted when the hotel has no chain recorded.",
            "example": "Accor"
          },
          "Brand": {
            "type": "string",
            "description": "Product line within the chain the property is marketed under. Omitted when the hotel has no brand recorded.",
            "example": "Novotel"
          },
          "Location": {
            "$ref": "#/components/schemas/Location"
          },
          "FactualAttributes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FactualAttribute"
            },
            "description": "Hotel-level factual attributes (amenities, facilities, grouped on-site facility families, and group header rows)."
          },
          "POIs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/POI"
            },
            "description": "Nearby points of interest with localized names and, where there is one to show, distances."
          },
          "CheckIn": {
            "$ref": "#/components/schemas/CheckIn"
          },
          "CheckOut": {
            "$ref": "#/components/schemas/CheckOut"
          },
          "GeneratedTexts": {
            "$ref": "#/components/schemas/GeneratedTexts"
          },
          "GuestRating": {
            "$ref": "#/components/schemas/GuestRating"
          },
          "RenderLayouts": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Optional rendering hints, not enrichment data: template key to layout hint such as `prose`, `highlights`, `roomcards` or `summary`. Only keys whose template carries a hint are included.",
            "example": {
              "Summary": "prose",
              "HouseRules": "highlights"
            }
          },
          "Images": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Image"
            },
            "description": "Hotel-level images, deduplicated and sorted by category priority. An image pinned in your project's content set (see PinnedImageID) is served first, ahead of that order."
          },
          "PinnedImageID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the pinned image promoted to the front of `Images`, always the first entry's ID. Omitted when no pin is in effect.",
            "example": "0192fb20-1aa2-7def-9abc-1122334455aa"
          },
          "Rooms": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EnrichedRoom"
            },
            "description": "Enriched room types belonging to this hotel."
          },
          "Tags": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProjectTagSummary"
            },
            "description": "Internal tags of your project's content set applied to the hotel (your project's, or instead those of the project YGO set it to share content from). Present only when the hotel carries one or more; omitted otherwise."
          },
          "Status": {
            "type": "string",
            "enum": [
              "draft",
              "active",
              "inactive",
              "closed_temporarily",
              "closed_permanently",
              "removed"
            ],
            "description": "The hotel's status in your project, first match wins: `closed_permanently`, `closed_temporarily`, `removed` (out of the catalog), `inactive`, `active` (active in the catalog, with texts), else `draft`.",
            "example": "active"
          },
          "TextStatus": {
            "type": "string",
            "enum": [
              "none",
              "generating",
              "generated",
              "failed"
            ],
            "description": "Your project's text state of the hotel, first match wins: `generating`, `failed` (latest generation failed; older texts stay), `generated` (texts held), else `none`.",
            "example": "generated"
          },
          "CreatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the hotel record was created (RFC3339).",
            "example": "2026-03-01T08:00:00Z"
          },
          "UpdatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the hotel record was last updated (RFC3339).",
            "example": "2026-04-12T09:15:00Z"
          }
        }
      },
      "EnrichedHotelSummary": {
        "type": "object",
        "required": [
          "ID",
          "Name",
          "Stars",
          "StarsMap",
          "CountryCode",
          "City",
          "Status",
          "TextEnrichmentStatus",
          "CreatedAt",
          "UpdatedAt"
        ],
        "description": "A hotel row for lists: identity, location, status, up to five images, the Summary text per locale and the nearest beach and airport. A row whose content could not be built has no Images, GeneratedTexts or NearestPOIs.",
        "properties": {
          "ID": {
            "type": "string",
            "format": "uuid",
            "description": "Unique hotel UUID.",
            "example": "0192fb17-5dc6-7abc-8def-123456789abc"
          },
          "Name": {
            "type": "string",
            "description": "Normalized English (en-US) hotel display name.",
            "example": "Bahia Azul Beach Resort"
          },
          "ExternalHotelIDs": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "External identifiers this hotel is known by, omitted when it has none. Current keys are `ProductID`, `Giata` and `PeakworkGoalID`, each only when it applies; the map is open, so read the keys you need.",
            "example": {
              "ProductID": "HTL-MAJ-4711",
              "Giata": "668370",
              "PeakworkGoalID": "864521"
            }
          },
          "GlobalHotelID": {
            "type": "string",
            "description": "Cross-tenant global hotel identifier. Omitted when the hotel has no global ID assigned.",
            "example": "ES-MALLR-K7MP2"
          },
          "Stars": {
            "type": "number",
            "format": "float",
            "description": "The hotel's default star grade (StarsMap.default.Stars); 0 when unrated.",
            "example": 4
          },
          "StarsMap": {
            "$ref": "#/components/schemas/listEnrichedHotelSummaries_StarsMap"
          },
          "CountryCode": {
            "type": "string",
            "description": "ISO 3166-1 alpha-2 country code.",
            "example": "ES"
          },
          "City": {
            "type": "string",
            "description": "City or town, derived from the hotel's address. Empty when unavailable.",
            "example": "Palma"
          },
          "CityNames": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Localized city names keyed by BCP 47 language tag, present only once generated; values are non-empty, and a locale with no established exonym carries the local name. Fall back to City.",
            "example": {
              "en-US": "Rome",
              "de-DE": "Rom",
              "it-IT": "Roma"
            }
          },
          "Status": {
            "type": "string",
            "enum": [
              "draft",
              "active",
              "inactive",
              "closed_temporarily",
              "closed_permanently",
              "removed"
            ],
            "description": "The hotel's status in your project, first match wins: `closed_permanently`, `closed_temporarily`, `removed` (out of the catalog), `inactive`, `active` (active in the catalog, with texts), else `draft`.",
            "example": "active"
          },
          "TextEnrichmentStatus": {
            "type": "string",
            "deprecated": true,
            "enum": [
              "enriched",
              "enriching",
              "none"
            ],
            "description": "Deprecated: use `TextStatus`. Derived per-hotel generated-text state: 'enriched' (texts generated), 'enriching' (generation in progress), or 'none' (no texts yet).",
            "example": "enriched"
          },
          "TextStatus": {
            "type": "string",
            "enum": [
              "none",
              "generating",
              "generated",
              "failed"
            ],
            "description": "Your project's text state of the hotel, first match wins: `generating`, `failed` (latest generation failed; older texts stay), `generated` (texts held), else `none`.",
            "example": "generated"
          },
          "LastEnrichedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp of the most recent enrichment run for this hotel (RFC3339). Empty when the hotel has never been enriched.",
            "example": "2026-04-12T09:15:00Z"
          },
          "FullyEnrichedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the hotel completed full enrichment (RFC3339). Empty when the hotel is not fully enriched.",
            "example": "2026-04-12T09:15:00Z"
          },
          "Latitude": {
            "type": "number",
            "format": "double",
            "description": "Latitude of the hotel's stored location in decimal degrees (WGS 84). Absent together with Longitude when the hotel has no coordinates (null or 0,0).",
            "example": 39.5696
          },
          "Longitude": {
            "type": "number",
            "format": "double",
            "description": "Longitude of the hotel's stored location in decimal degrees (WGS 84). Absent together with Latitude when the hotel has no coordinates (null or 0,0).",
            "example": 2.6502
          },
          "Tags": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/listEnrichedHotelSummaries_ProjectTagSummary"
            },
            "description": "This project's internal tags applied to the hotel. Present only when the hotel carries one or more; omitted otherwise."
          },
          "LastFeedbackAt": {
            "type": "string",
            "format": "date-time",
            "description": "Creation time of the newest comment on this hotel in your project, rejected ones included and withdrawn ones not, RFC 3339 UTC with fractional seconds. Omitted when none, or without content.authoring:read.",
            "example": "2026-10-07T08:41:12.483917Z"
          },
          "LastFeedbackReplyAt": {
            "type": "string",
            "format": "date-time",
            "description": "The newest review-team answer on the comments counted for LastFeedbackAt: the creation time of the newest review-team reply in such a comment's thread, or, for an answer stored on the row itself (one written before threaded replies, or the decision on a photo upload, which takes no reply), the row's update time, whichever is newer; a review-team redaction of such a row also moves it. RFC 3339 UTC with fractional seconds. Omitted when none or without content.authoring:read.",
            "example": "2026-10-07T10:18:05.903311Z"
          },
          "Images": {
            "type": "array",
            "maxItems": 5,
            "items": {
              "$ref": "#/components/schemas/SummaryImage"
            },
            "description": "The cover image, then up to four more in the order the hotel's gallery serves them, so a pinned image stays first. Omitted when the hotel has no images or its content could not be built."
          },
          "GeneratedTexts": {
            "allOf": [
              {
                "$ref": "#/components/schemas/SummaryGeneratedTexts"
              }
            ],
            "description": "The hotel's Summary text per locale, with your project's static texts (such as promotions or disclaimers) composed in at request time. Omitted when no locale has a Summary or the content could not be built."
          },
          "NearestPOIs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/NearestPOI"
            },
            "description": "The nearest point of interest per type, at most one each: currently `beach` and `airport`; a type with none is absent. Omitted when there is none or the content could not be built."
          },
          "CreatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the hotel record was created (RFC3339).",
            "example": "2026-03-01T08:00:00Z"
          },
          "UpdatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the hotel record was last updated (RFC3339).",
            "example": "2026-04-12T09:15:00Z"
          }
        }
      },
      "EnrichedRoom": {
        "type": "object",
        "required": [
          "ID",
          "Name",
          "FactualAttributes",
          "RenderLayouts",
          "Images",
          "Status",
          "CreatedAt",
          "UpdatedAt"
        ],
        "description": "An enriched room type belonging to a hotel.",
        "properties": {
          "ID": {
            "type": "string",
            "format": "uuid",
            "description": "Unique room UUID.",
            "example": "0192fb30-2bb3-7abc-8def-99887766aabb"
          },
          "Name": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Localized room names keyed by BCP 47 language tag. Always contains en-US when a base room name exists.",
            "example": {
              "en-US": "Double Room Sea View",
              "de-DE": "Doppelzimmer mit Meerblick"
            }
          },
          "SizeSqm": {
            "type": "integer",
            "description": "Room size in square meters. 0 when unknown.",
            "example": 26
          },
          "Beddings": {
            "type": "array",
            "items": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/Bedding"
              }
            },
            "description": "Bedding configurations. The outer array lists alternative configurations; each inner array lists the beds in one configuration."
          },
          "FactualAttributes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FactualAttribute"
            },
            "description": "Room-level factual attributes."
          },
          "GeneratedTexts": {
            "$ref": "#/components/schemas/GeneratedTexts"
          },
          "RenderLayouts": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Optional rendering hints keyed by room template namespace (empty string for bare template keys). One layout governs the whole room card.",
            "example": {
              "": "roomcards"
            }
          },
          "ExternalRoomIDs": {
            "type": "object",
            "additionalProperties": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "description": "Your own identifiers for this room, omitted when it has none. Current key is `ProductRoomIDs`, sorted and included only for confident matches; several ids can map to one room.",
            "example": {
              "ProductRoomIDs": [
                "11824",
                "11902"
              ]
            }
          },
          "Images": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Image"
            },
            "description": "Room-level images, deduplicated and sorted by category priority."
          },
          "Status": {
            "type": "string",
            "description": "Room lifecycle status (e.g. active).",
            "example": "active"
          },
          "CreatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the room record was created (RFC3339).",
            "example": "2026-03-01T08:00:00Z"
          },
          "UpdatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the room record was last updated (RFC3339).",
            "example": "2026-04-10T12:30:00Z"
          }
        }
      },
      "ErrorDetail": {
        "type": "object",
        "required": [
          "Code",
          "Message"
        ],
        "description": "Error detail containing a machine-readable code and human-readable message.",
        "properties": {
          "Code": {
            "type": "string",
            "description": "Machine-readable error code for programmatic handling.",
            "example": "VALIDATION_ERROR"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable error message.",
            "example": "Validation failed"
          },
          "Fields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FieldError"
            },
            "description": "Field-level validation errors. Only present for VALIDATION_ERROR responses."
          }
        }
      },
      "ErrorResponse": {
        "type": "object",
        "required": [
          "Error"
        ],
        "description": "Standard v2 error response wrapper.",
        "properties": {
          "Error": {
            "$ref": "#/components/schemas/ErrorDetail"
          }
        }
      },
      "ExportApprovedHotelTextRequest": {
        "type": "object",
        "required": [
          "HotelID"
        ],
        "description": "The hotel to export. The locale is always the project's default locale; the request names none.",
        "properties": {
          "HotelID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the hotel. Required, a valid non-nil UUID, and a live member of the calling project.",
            "example": "019f412f-c41c-746e-b569-e6454677366c"
          }
        }
      },
      "FactualAttribute": {
        "type": "object",
        "required": [
          "Key",
          "Name",
          "ValueType"
        ],
        "description": "A factual attribute. A single fact carries a scalar `Value`; a grouped facility family carries `Instances` and an empty `Value`; a group header carries `ValueType` `group`.",
        "properties": {
          "Key": {
            "type": "string",
            "description": "Canonical attribute key.",
            "example": "wifi"
          },
          "Type": {
            "type": "string",
            "description": "Ontology kind resolved from the attribute tree at serve time. For this surface the value is 'factual'.",
            "example": "factual"
          },
          "Name": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Localized attribute display names keyed by BCP 47 language tag.",
            "example": {
              "en-US": "Free WiFi",
              "de-DE": "Kostenloses WLAN"
            }
          },
          "Value": {
            "type": "string",
            "description": "Scalar value for a single fact, empty for grouped families and headers. It carries the polarity, so always render the attribute with its `Value`, never from `Name` alone.",
            "example": "true"
          },
          "ValueType": {
            "type": "string",
            "description": "How Value should be interpreted: 'boolean', 'text', or 'group' for a group header row.",
            "example": "boolean"
          },
          "ParentKey": {
            "type": "string",
            "description": "Key of the parent category this attribute belongs to (used by clients as a section grouping).",
            "example": "facilities_and_services"
          },
          "Details": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Additional free-text properties in the source language, such as description or Category; their translations are under DetailsLocalized. Omitted when empty."
          },
          "IsFree": {
            "type": "boolean",
            "nullable": true,
            "description": "Whether the amenity is free of charge. true (free), false (paid), or null when unknown / not applicable.",
            "example": true
          },
          "IsOnSite": {
            "type": "boolean",
            "description": "Whether the facility or activity is on the hotel's premises (true) or only in the surrounding area (false), for example a golf course 12 km away. Hotel facts only; omitted when not determined, never null.",
            "example": false
          },
          "GTCodes": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "DRV GlobalTypes codes for this attribute, general to specific: concept code, optional SubType refinement, then a free-of-charge qualifier. Omitted when the attribute has no mapping.",
            "example": [
              "GT03-POOL",
              "ST03-INSW"
            ]
          },
          "ValueLocalized": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Per-locale translations of the free-text Value, keyed by BCP 47 language tag; a boolean Value normally carries none. Present only when translations exist, otherwise fall back to Value."
          },
          "DetailsLocalized": {
            "type": "object",
            "additionalProperties": {
              "type": "object",
              "additionalProperties": {
                "type": "string"
              }
            },
            "description": "Per-locale translations of the free-text Details, keyed by property key, then by BCP 47 language tag. Present only when translations exist, otherwise fall back to Details."
          },
          "Instances": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FactualInstance"
            },
            "description": "Named outlets for a grouped on-site facility family, such as each restaurant or bar. Present only for grouped families, omitted for single-fact attributes."
          }
        }
      },
      "FactualInstance": {
        "type": "object",
        "required": [
          "Name"
        ],
        "description": "One named outlet within a grouped on-site facility family.",
        "properties": {
          "Name": {
            "type": "string",
            "description": "Display name of the outlet.",
            "example": "La Marea"
          },
          "Details": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Per-outlet free-text properties, such as description or hours. Omitted when empty."
          },
          "DetailsLocalized": {
            "type": "object",
            "additionalProperties": {
              "type": "object",
              "additionalProperties": {
                "type": "string"
              }
            },
            "description": "Per-property, per-locale translations of this outlet's free-text details, keyed propertyKey then BCP 47 language tag. Fall back to `Details`; omitted when empty."
          }
        }
      },
      "FeatureDetection": {
        "type": "object",
        "required": [
          "Label",
          "Confidence"
        ],
        "description": "One feature of the image with the confidence measured for it.",
        "properties": {
          "Label": {
            "type": "string",
            "description": "The feature label, from the same vocabulary as Features.",
            "example": "sea_view"
          },
          "Confidence": {
            "$ref": "#/components/schemas/DetectionConfidence"
          }
        }
      },
      "FieldError": {
        "type": "object",
        "required": [
          "Field",
          "Message"
        ],
        "description": "A single field-level validation error.",
        "properties": {
          "Field": {
            "type": "string",
            "description": "Path of the field that failed validation, as the request sends it: a dotted path for a field inside a nested request object, a bare name for a top-level one.",
            "example": "Name"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable validation error message for this field.",
            "example": "Name is required"
          },
          "Code": {
            "type": "string",
            "enum": [
              "REQUIRED",
              "TOO_LONG",
              "TOO_SHORT",
              "OUT_OF_RANGE",
              "TOO_MANY",
              "INVALID_FORMAT",
              "NOT_ALLOWED",
              "CONFLICT",
              "INVALID_ENCODING",
              "INSECURE_SCHEME",
              "UNSAFE_CONTENT",
              "REQUIRED_WHEN_ENABLED"
            ],
            "description": "Machine-readable reason the field failed validation. Optional; clients should fall back to Message when it is absent or unrecognized.",
            "example": "TOO_LONG"
          },
          "Params": {
            "type": "object",
            "additionalProperties": true,
            "description": "Machine-readable values the message is built from, such as limits or allowed values. Keys are PascalCase; which keys are present depends on Code. Optional.",
            "example": {
              "Max": 200
            }
          }
        }
      },
      "GenerateTextRequest": {
        "type": "object",
        "description": "Request body for queuing a text-generation run. At least one of HotelIDs or TagIDs must be provided. HotelIDs and the hotels resolved from TagIDs are combined and deduplicated; the result is capped at 100 hotels.",
        "properties": {
          "HotelIDs": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "Explicit hotel UUIDs to generate text for. Each hotel must belong to the calling project; a hotel outside the project's scope returns 404. Required if TagIDs is empty.",
            "example": [
              "0192fb17-5dc6-7abc-8def-123456789abc",
              "0192fb18-6ed7-7abc-8def-223456789abc"
            ]
          },
          "TagIDs": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "Tag UUIDs. Hotels carrying ALL of the given tags (intersection) and belonging to the project are added to the selection. Required if HotelIDs is empty.",
            "example": [
              "0192fb40-7aa1-7abc-8def-aabbccddeeff"
            ]
          },
          "TemplateKeys": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Optional subset of active template keys to (re)generate. Each key must be an active template of the project. Empty means all active templates. Maximum 100 keys.",
            "example": [
              "Summary",
              "HouseRules"
            ]
          },
          "Locales": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Optional subset of BCP 47 language tags to generate. Empty means the locales configured on the matched templates (always including en-US).",
            "example": [
              "en-US",
              "de-DE"
            ]
          },
          "RegenMode": {
            "type": "string",
            "enum": [
              "fill_missing",
              "full"
            ],
            "default": "fill_missing",
            "description": "Controls which texts are (re)generated. 'fill_missing' (the default) generates only missing or stale texts; 'full' regenerates every selected text.",
            "example": "fill_missing"
          }
        }
      },
      "GenerateTextResponse": {
        "type": "object",
        "required": [
          "Data"
        ],
        "description": "Single-object response envelope wrapping the queued text-generation run.",
        "properties": {
          "Data": {
            "$ref": "#/components/schemas/TextGenerationRun"
          }
        }
      },
      "GeneratedTextDetail": {
        "type": "object",
        "required": [
          "Text"
        ],
        "description": "One generated text for a (locale, template key) pair. Every text served here is AI-generated and therefore carries a `Compliance` marker envelope.",
        "properties": {
          "Text": {
            "type": "string",
            "description": "The generated text, sanitized for display.",
            "example": "Set on a quiet stretch of the Bay of Palma, Bahia Azul Beach Resort pairs direct beach access with bright, contemporary rooms and a sea-view rooftop pool."
          },
          "GeneratedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Per-text generation timestamp (RFC3339). Omitted for legacy / unstamped texts.",
            "example": "2026-04-12T09:15:00Z"
          },
          "TextType": {
            "type": "string",
            "description": "Set to 'rules' for rule-based texts (policies, house rules). Omitted for marketing texts.",
            "example": "rules"
          },
          "Compliance": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Compliance"
              }
            ],
            "description": "Regulatory marker envelope, present whenever the text is non-empty; `AIGenerated` is always `true`. Omitted on an empty text."
          }
        }
      },
      "GeneratedTexts": {
        "type": "object",
        "description": "Generated texts keyed by locale (BCP 47 language tag) then by template key; each value is a GeneratedTextDetail.",
        "additionalProperties": {
          "type": "object",
          "additionalProperties": {
            "$ref": "#/components/schemas/GeneratedTextDetail"
          }
        }
      },
      "GetContentSettingsRequest": {
        "type": "object",
        "description": "Request body for fetching content settings. No parameters are required; send an empty object.",
        "properties": {}
      },
      "GetContentSettingsResponse": {
        "type": "object",
        "required": [
          "Data"
        ],
        "description": "Single-object response envelope wrapping the content settings.",
        "properties": {
          "Data": {
            "$ref": "#/components/schemas/ContentSettings"
          }
        }
      },
      "GetEnrichedHotelRequest": {
        "type": "object",
        "description": "Request body for fetching one enriched hotel. Provide exactly one selector: `HotelID`, `GlobalHotelID` or `ExternalHotelID`.",
        "properties": {
          "HotelID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the enriched hotel to retrieve, one of three mutually exclusive selectors. The hotel must be in your project's content set: your project's, or instead that of the project YGO set it to share content from.",
            "example": "0192fb17-5dc6-7abc-8def-123456789abc"
          },
          "GlobalHotelID": {
            "type": "string",
            "description": "Cross-tenant global hotel identifier, one of three mutually exclusive selectors. The resolved hotel must be in your project's content set (see `HotelID`).",
            "example": "ES-MALLR-K7MP2"
          },
          "ExternalHotelID": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Resolve the hotel by your own identifiers, AND-combined when several are given. Sub-key names are case-insensitive; `productid` compares exactly, `giata` and `peakworkgoalid` are positive integers compared by number, `giata` up to 2147483647.",
            "example": {
              "productid": "HTL-MAJ-4711"
            }
          }
        }
      },
      "GetEnrichedHotelResponse": {
        "type": "object",
        "required": [
          "Data"
        ],
        "description": "Single-object response envelope wrapping the enriched hotel.",
        "properties": {
          "Data": {
            "$ref": "#/components/schemas/EnrichedHotel"
          }
        }
      },
      "GetTextGenerationStatusRequest": {
        "type": "object",
        "required": [
          "RunID"
        ],
        "description": "Request body for fetching the status of a single text-generation run.",
        "properties": {
          "RunID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the text-generation run to retrieve, as returned by generateText. The run must belong to the calling project.",
            "example": "0192fb50-8bb2-7abc-8def-112233445566"
          }
        }
      },
      "GetTextGenerationStatusResponse": {
        "type": "object",
        "required": [
          "Data"
        ],
        "description": "Single-object response envelope wrapping the text-generation run status.",
        "properties": {
          "Data": {
            "$ref": "#/components/schemas/TextGenerationStatus"
          }
        }
      },
      "GetVisionImagesRequest": {
        "type": "object",
        "required": [
          "ImageIDs"
        ],
        "description": "Request body for polling submitted images by image ID.",
        "properties": {
          "ImageIDs": {
            "type": "array",
            "minItems": 1,
            "maxItems": 100,
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "Image UUIDs returned by ingestVisionImages, between 1 and 100 per request. The response returns one entry per ID, in this order.",
            "example": [
              "0192fb20-1aa2-7def-9abc-1122334455aa",
              "0192fb21-2bb3-7def-9abc-2233445566bb"
            ]
          }
        }
      },
      "GetVisionImagesResponse": {
        "type": "object",
        "required": [
          "Data"
        ],
        "description": "Single-object response envelope wrapping the polled image states.",
        "properties": {
          "Data": {
            "$ref": "#/components/schemas/GetVisionImagesResult"
          }
        }
      },
      "GetVisionImagesResult": {
        "type": "object",
        "required": [
          "Images"
        ],
        "description": "The state of every polled image.",
        "properties": {
          "Images": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/VisionImageState"
            },
            "description": "One entry per requested image ID, in request order."
          }
        }
      },
      "GuestRating": {
        "type": "object",
        "required": [
          "ReviewScore"
        ],
        "description": "Guest rating of the hotel: the guest review scores we hold, calibrated per platform and aggregated on a 0 to 100 scale, with category scores and summaries. Omitted when the hotel has no rating.",
        "properties": {
          "ReviewScore": {
            "type": "integer",
            "minimum": 0,
            "maximum": 100,
            "description": "Overall guest score from 0 to 100: the aggregate of the guest review scores we hold, each calibrated per review platform.",
            "example": 93
          },
          "SubScores": {
            "$ref": "#/components/schemas/GuestRatingSubScores"
          },
          "Texts": {
            "$ref": "#/components/schemas/GuestRatingTexts"
          }
        }
      },
      "GuestRatingSubScores": {
        "type": "object",
        "description": "Category scores from 0 to 100 showing how a category compares with the hotel overall. A category without data is absent, never 0; omitted when no category has data.",
        "properties": {
          "Cleanliness": {
            "type": "integer",
            "minimum": 0,
            "maximum": 100,
            "description": "Score for cleanliness, 0 to 100.",
            "example": 96
          },
          "Service": {
            "type": "integer",
            "minimum": 0,
            "maximum": 100,
            "description": "Score for staff and service, 0 to 100.",
            "example": 96
          },
          "Location": {
            "type": "integer",
            "minimum": 0,
            "maximum": 100,
            "description": "Score for the location, 0 to 100.",
            "example": 91
          },
          "Rooms": {
            "type": "integer",
            "minimum": 0,
            "maximum": 100,
            "description": "Score for the rooms, 0 to 100.",
            "example": 95
          },
          "Food": {
            "type": "integer",
            "minimum": 0,
            "maximum": 100,
            "description": "Score for food and drink, 0 to 100.",
            "example": 91
          },
          "Value": {
            "type": "integer",
            "minimum": 0,
            "maximum": 100,
            "description": "Score for value for money, 0 to 100.",
            "example": 90
          },
          "Facilities": {
            "type": "integer",
            "minimum": 0,
            "maximum": 100,
            "description": "Score for the facilities, 0 to 100.",
            "example": 93
          }
        }
      },
      "GuestRatingText": {
        "type": "object",
        "required": [
          "Summary"
        ],
        "description": "What guests say about the hotel in one locale: a short summary with the points most often praised and criticized.",
        "properties": {
          "Summary": {
            "type": "string",
            "description": "Short paragraph summarizing guest opinion of the hotel.",
            "example": "Guests consistently describe their stay as a peaceful, relaxing retreat highlighted by exceptionally friendly and attentive staff. Rooms and grounds are praised for being spotless and comfortable, while the delicious breakfast and calm adults-only setting make it an ideal getaway."
          },
          "Pros": {
            "type": "array",
            "maxItems": 5,
            "items": {
              "type": "string"
            },
            "description": "Up to 5 points guests praise. Omitted when there are none.",
            "example": [
              "Warm, attentive, and professional staff",
              "Spotless rooms and well-kept grounds",
              "Peaceful, child-free atmosphere",
              "Superb and varied breakfast spread",
              "Modern, spacious guest rooms"
            ]
          },
          "Cons": {
            "type": "array",
            "maxItems": 3,
            "items": {
              "type": "string"
            },
            "description": "Up to 3 points guests criticize. Omitted when there are none.",
            "example": [
              "Extra charges for some premium drinks and minibar",
              "Lunch and dinner buffets can feel repetitive to some"
            ]
          },
          "GeneratedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Generation timestamp of this text (RFC3339). Omitted for an unstamped text.",
            "example": "2026-11-05T18:10:57Z"
          },
          "Compliance": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Compliance"
              }
            ],
            "description": "Regulatory marker envelope, present on every served text; `AIGenerated` is always `true`."
          }
        }
      },
      "GuestRatingTexts": {
        "type": "object",
        "description": "AI-generated summaries of guest opinion keyed by locale (BCP 47 language tag); they quote no review. Omitted when no text has been generated.",
        "additionalProperties": {
          "$ref": "#/components/schemas/GuestRatingText"
        }
      },
      "HotelImagePin": {
        "type": "object",
        "required": [
          "HotelID",
          "ImageID",
          "CreatedBy"
        ],
        "description": "The project's pinned first image for a hotel.",
        "properties": {
          "HotelID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the hotel the pin applies to.",
            "example": "0192fb17-5dc6-7abc-8def-123456789abc"
          },
          "ImageID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the pinned image, as saved. Note that getEnrichedHotel echoes the pin as PinnedImageID — the id of the served image at the front of Images — which can differ from this id when the gallery serves a deduplicated equivalent of the pinned image.",
            "example": "0192fb20-1aa2-7def-9abc-1122334455aa"
          },
          "CreatedBy": {
            "type": "string",
            "description": "Audit identity of who saved the pin: a user token records the user's email; a project (proj_) machine token records its project-scoped identity (e.g. 'project:<project-uuid>').",
            "example": "editor@example.com"
          }
        }
      },
      "HotelStars": {
        "type": "object",
        "required": [
          "HotelID",
          "Stars"
        ],
        "description": "Your project's own star grade for a hotel.",
        "properties": {
          "HotelID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the hotel the grade applies to.",
            "example": "0192fb17-5dc6-7abc-8def-123456789abc"
          },
          "Stars": {
            "type": "number",
            "format": "float",
            "description": "The saved grade, greater than 0 and at most 10, with at most one decimal.",
            "example": 4.5
          }
        }
      },
      "Image": {
        "type": "object",
        "required": [
          "ID",
          "URL"
        ],
        "description": "An enriched image with vision-derived metadata.",
        "properties": {
          "ID": {
            "type": "string",
            "format": "uuid",
            "description": "Unique image UUID.",
            "example": "0192fb20-1aa2-7def-9abc-1122334455aa"
          },
          "URL": {
            "type": "string",
            "format": "uri",
            "description": "Image URL.",
            "example": "https://cdn.ygo.ai/hotels/bahia-azul/exterior-pool.jpg"
          },
          "Source": {
            "type": "string",
            "description": "Detected provenance of the pixels: `photo`, `render`, `illustration` or `ai_generated`. Omitted when the image carries no provenance assessment.",
            "example": "photo"
          },
          "Category": {
            "type": "string",
            "description": "Vision-derived image category (e.g. exterior, room, pool, restaurant).",
            "example": "exterior"
          },
          "Features": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Vision-derived feature tags depicted in the image.",
            "example": [
              "pool",
              "sea_view"
            ]
          },
          "Mood": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Vision-derived mood descriptors.",
            "example": [
              "relaxing"
            ]
          },
          "Tags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Additional vision-derived tags.",
            "example": [
              "rooftop",
              "sunset"
            ]
          },
          "Flags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Quality / content flags raised by vision analysis. Omitted when empty."
          },
          "AppealScore": {
            "type": "integer",
            "description": "Appeal score from 0 to 100, or -1 when there is no scorer-stamped value and no value above 0, normally because nothing has scored the image yet. -1 is not a score and does not affect image order.",
            "example": 88
          },
          "QualityScore": {
            "type": "integer",
            "description": "Technical quality score from 0 to 100, or -1 when there is no scorer-stamped value and no value above 0, normally because nothing has scored the image yet. -1 is not a score and does not affect image order.",
            "example": 91
          },
          "AppealScoreVersion": {
            "type": "string",
            "description": "Version stamp of the scorer that produced AppealScore, for example `app-v4`; it may name an earlier version. Absent when AppealScore is -1 or a legacy score from before stamps existed.",
            "example": "app-v4"
          },
          "QualityScoreVersion": {
            "type": "string",
            "description": "Version stamp of the scorer that produced QualityScore, for example `qs-v4`; it may name an earlier version. Absent when QualityScore is -1, a legacy score, or a first-seen image's provisional score.",
            "example": "qs-v4"
          },
          "Width": {
            "type": "integer",
            "description": "Image width in pixels.",
            "example": 1600
          },
          "Height": {
            "type": "integer",
            "description": "Image height in pixels.",
            "example": 1067
          },
          "Format": {
            "type": "string",
            "description": "Image format (e.g. jpeg, png, webp).",
            "example": "jpeg"
          },
          "FileSize": {
            "type": "integer",
            "description": "File size in bytes.",
            "example": 412000
          },
          "DominantColor": {
            "type": "string",
            "description": "Dominant color as a hex string.",
            "example": "#2E6F95"
          },
          "BlurHash": {
            "type": "string",
            "description": "BlurHash placeholder string for progressive loading.",
            "example": "LKO2?U%2Tw=w]~RBVZRi};RPxuwH"
          },
          "FileMetadata": {
            "type": "object",
            "description": "What the image file itself states in its embedded IPTC/EXIF/XMP metadata: capture date and copyright notice. Omitted when the file states neither; inside it, a value the file did not state has no key.",
            "properties": {
              "CaptureDate": {
                "type": "string",
                "pattern": "^\\d{4}(-\\d{2}(-\\d{2})?)?$",
                "description": "Date the photograph was taken, at the precision the file stated: `2012-06-14`, `2012-06` or `2012`. It carries no time of day and no timezone.",
                "example": "2012-06-14"
              },
              "Copyright": {
                "type": "string",
                "description": "The copyright notice the file carries, as the file wrote it. It names who to ask; it is not a machine-readable licence.",
                "example": "© 2012 Hotel Sol S.A."
              }
            },
            "example": {
              "CaptureDate": "2012-06-14",
              "Copyright": "© 2012 Hotel Sol S.A."
            }
          },
          "Descriptions": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Neutral alt text describing what the image shows, not marketing copy, keyed by BCP 47 language tag. More locales may be added after an image is first analyzed.",
            "example": {
              "en-US": "Rooftop infinity pool overlooking the Bay of Palma at sunset."
            }
          },
          "Compliance": {
            "allOf": [
              {
                "$ref": "#/components/schemas/Compliance"
              }
            ],
            "description": "EU AI Act Article 50(2) marker for this image. Always present with `AIGenerated` true: the category, features, mood, tags, scores and descriptions are model output, `FileMetadata` is not."
          },
          "Presence": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PresenceDetection"
            },
            "description": "People and animals seen in the image, from the closed vocabulary person, adult, child, animal. Omitted when the image carries no presence measurement."
          },
          "Safety": {
            "type": "object",
            "additionalProperties": {
              "$ref": "#/components/schemas/DetectionConfidence"
            },
            "description": "Safety confidences keyed by dimension, `Inappropriate` and `OffTopic`, each between 0 and 1 or null. Omitted when the image carries no safety measurement."
          },
          "TextDetections": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TextDetection"
            },
            "description": "Texts read off the image, each with its kind. Omitted when the image carries no text measurement."
          },
          "FeatureDetections": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FeatureDetection"
            },
            "description": "The image's features with the confidence measured for each, running parallel to `Features`. Omitted when the image carries no feature measurement."
          },
          "Nudity": {
            "type": "object",
            "description": "Nudity assessment: exposure score, reason and explicit flag, independent of `Safety.Inappropriate`. Omitted when the assessment did not run or the image's `Presence` shows no person.",
            "required": [
              "Score",
              "Reason",
              "Explicit"
            ],
            "properties": {
              "Score": {
                "type": "integer",
                "minimum": 0,
                "maximum": 100,
                "description": "Exposure score from 0 to 100. Anchors: 20 beach or casual wear, 40 standard swimwear, 60 revealing swimwear or lingerie, 80 partial nudity, 100 explicit.",
                "example": 60
              },
              "Reason": {
                "type": "string",
                "description": "One model-written sentence naming what drives the score, at most 240 characters. Not sanitized for markup, so escape it before rendering.",
                "example": "Adult in revealing swimwear by the pool."
              },
              "Explicit": {
                "type": "boolean",
                "description": "True from a score of 90 up. Whether a child is in the picture is answered by `Presence`, not here.",
                "example": false
              }
            }
          }
        }
      },
      "IngestVisionImagesRequest": {
        "type": "object",
        "required": [
          "Images"
        ],
        "description": "Request body for submitting image URLs. Provide at most one hotel selector, or none to submit images without a hotel.",
        "properties": {
          "HotelID": {
            "type": "string",
            "format": "uuid",
            "description": "Hotel UUID, one of three optional, mutually exclusive selectors. Resolves only: an unknown UUID or a hotel you cannot reach (see the operation description) returns 404.",
            "example": "0192fb17-5dc6-7abc-8def-123456789abc"
          },
          "GlobalHotelID": {
            "type": "string",
            "description": "Cross-tenant global hotel identifier, one of three optional and mutually exclusive selectors. Resolves only: an unknown identifier or a hotel you cannot reach (see the operation description) returns 404.",
            "example": "ES-MALLR-K7MP2"
          },
          "ExternalHotelID": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Your own hotel identifiers, sub-keys `productid` and `giata`, AND-combined. Unless `giata` is alone, a hotel you cannot reach (see the operation description) returns 404; only `giata` alone can create one.",
            "example": {
              "productid": "IBS-MAJ-4711"
            }
          },
          "HotelName": {
            "type": "string",
            "maxLength": 500,
            "description": "Name of the hotel, required with a selector and refused without one, max 500 characters. Used only when a hotel is created, never written onto one that already exists.",
            "example": "Hotel Bahia Azul"
          },
          "Images": {
            "type": "array",
            "minItems": 1,
            "maxItems": 100,
            "items": {
              "$ref": "#/components/schemas/VisionImageSubmission"
            },
            "description": "The images to submit, between 1 and 100 per request. Every entry belongs to the hotel this request selects, or to the project's placeholder hotel when no selector is sent."
          }
        }
      },
      "IngestVisionImagesResponse": {
        "type": "object",
        "required": [
          "Data"
        ],
        "description": "Single-object response envelope wrapping the ingest result.",
        "properties": {
          "Data": {
            "$ref": "#/components/schemas/IngestVisionImagesResult"
          }
        }
      },
      "IngestVisionImagesResult": {
        "type": "object",
        "required": [
          "HotelID",
          "Images"
        ],
        "description": "The hotel the images were attached to and the per-image outcome of the submission.",
        "properties": {
          "HotelID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the hotel the submitted images belong to. For a submission that named no hotel this is the project's placeholder hotel, and every later hotel-less submission returns that same ID.",
            "example": "0192fb17-5dc6-7abc-8def-123456789abc"
          },
          "Images": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/IngestedImage"
            },
            "description": "One entry per submitted image, in request order."
          }
        }
      },
      "IngestedImage": {
        "type": "object",
        "required": [
          "ImageID",
          "URL",
          "Status"
        ],
        "description": "The outcome for one submitted image URL.",
        "properties": {
          "ImageID": {
            "type": "string",
            "format": "uuid",
            "description": "Image UUID to poll with getVisionImages. For a URL that was already submitted for this hotel, this is the ID of the image that already carries it.",
            "example": "0192fb20-1aa2-7def-9abc-1122334455aa"
          },
          "URL": {
            "type": "string",
            "format": "uri",
            "description": "The submitted image URL.",
            "example": "https://images.example-client.com/1234567/exterior-pool.jpg"
          },
          "Status": {
            "type": "string",
            "enum": [
              "pending",
              "completed",
              "failed"
            ],
            "description": "Current state of this image: `pending` keep polling, `completed` the result is ready to fetch, `failed` the URL could not be fetched. Fix a failed URL and submit it again.",
            "example": "pending"
          }
        }
      },
      "ListApprovalImageUploadsRequest": {
        "type": "object",
        "required": [
          "HotelID"
        ],
        "description": "The hotel whose uploads to list.",
        "properties": {
          "HotelID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the hotel. Required, a valid non-nil UUID, and a live member of the calling project.",
            "example": "019d9c2e-0ef8-7458-b0fa-8bed7182eb30"
          }
        }
      },
      "ListApprovalImageUploadsResponse": {
        "type": "object",
        "required": [
          "Data"
        ],
        "description": "Single-object response envelope wrapping the hotel's uploads.",
        "properties": {
          "Data": {
            "$ref": "#/components/schemas/ApprovalImageUploadList"
          }
        }
      },
      "ListApprovalsRequest": {
        "type": "object",
        "description": "Filter and page the project's approval links. An empty body lists every link of the project.",
        "properties": {
          "HotelIDs": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "maxItems": 500,
            "description": "Restrict the list to these hotels. Optional, at most 500 entries, each a valid non-nil UUID; omit it to list every link of the project. Duplicates are collapsed.",
            "example": [
              "019d9c2e-0ef8-7458-b0fa-8bed7182eb30",
              "019d9c23-1238-7334-bf02-4c45c50e033a"
            ]
          },
          "Limit": {
            "type": "integer",
            "minimum": 0,
            "maximum": 500,
            "default": 100,
            "description": "Page size. Defaults to 100 when omitted or 0, and is capped at 500.",
            "example": 100
          },
          "Offset": {
            "type": "integer",
            "minimum": 0,
            "default": 0,
            "description": "Number of links to skip. Defaults to 0.",
            "example": 0
          }
        }
      },
      "ListApprovalsResponse": {
        "type": "object",
        "required": [
          "Data",
          "Pagination"
        ],
        "description": "List response envelope wrapping the links, plus the membership residue.",
        "properties": {
          "Data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/listApprovals_ApprovalLink"
            },
            "description": "The project's approval links, ordered by creation time then hotel id. Always present, empty when nothing matched. Links revoked before their hotel approved are not listed."
          },
          "Pagination": {
            "$ref": "#/components/schemas/Pagination"
          },
          "NotInProjectIDs": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "Requested hotel ids that are not live members of the calling project and were therefore skipped. Omitted when every requested id was a member.",
            "example": [
              "019e4afb-e973-764c-9bb1-a4c66175e08b"
            ]
          }
        }
      },
      "ListEnrichedHotelSummariesRequest": {
        "type": "object",
        "description": "Request body for listing the project's hotels. All fields are optional; omit the body to fetch the first page with default paging.",
        "properties": {
          "CountryCode": {
            "type": "string",
            "description": "Filter to hotels in this ISO 3166-1 alpha-2 country code. Omit to include all countries.",
            "example": "ES"
          },
          "Status": {
            "type": "string",
            "enum": [
              "draft",
              "active",
              "inactive",
              "closed_temporarily",
              "closed_permanently",
              "removed"
            ],
            "description": "Filter by the hotel's status in your project, one value (see `Status` on the rows). Any other value answers 400.",
            "example": "active"
          },
          "TextStatus": {
            "type": "string",
            "enum": [
              "none",
              "generating",
              "generated",
              "failed"
            ],
            "description": "Filter by your project's text state of the hotel, one value (see `TextStatus` on the rows). Any other value answers 400.",
            "example": "generated"
          },
          "IsFullyEnriched": {
            "type": "boolean",
            "description": "When true, restrict the list to hotels that have completed full enrichment.",
            "example": true
          },
          "Search": {
            "type": "string",
            "description": "Free-text search term matched against hotel name and related identity fields.",
            "example": "beach resort"
          },
          "CodeKind": {
            "type": "string",
            "description": "Filter to hotels carrying a code of this kind and surface that kind's master code. When omitted, no code-kind filter is applied and each hotel's canonical master code (or its smallest available code kind) is surfaced.",
            "example": "peakwork_master"
          },
          "TextEnrichmentStatus": {
            "type": "string",
            "deprecated": true,
            "enum": [
              "enriched",
              "enriching",
              "none"
            ],
            "description": "Deprecated: use `TextStatus`. Filter by the per-hotel generated-text state: 'enriched' (texts generated), 'enriching' (generation in progress), or 'none' (no texts yet).",
            "example": "enriched"
          },
          "TagIDs": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "Filter to hotels carrying all of these project tags, AND-combined with `TagName`. An unknown or foreign tag returns 404.",
            "example": [
              "0192fc01-1111-7abc-8def-aaaaaaaaaaaa",
              "0192fc02-2222-7abc-8def-bbbbbbbbbbbb"
            ]
          },
          "TagName": {
            "type": "string",
            "description": "Filter by a single project tag name, case-insensitive, AND-combined with `TagIDs`. An unknown name returns 404.",
            "example": "Summer Campaign"
          },
          "ExternalHotelIDs": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "type": "object",
              "additionalProperties": {
                "type": "string"
              },
              "description": "One selector: `productid`, compared exactly, or `giata` or `peakworkgoalid`, positive integers compared by number (`giata` up to 2147483647) or a 400. Sub-keys are AND-combined, names case-insensitive; a whitespace-only value is not provided."
            },
            "description": "Filter to hotels matching any of these selectors; elements are OR-ed, sub-keys within an element AND-ed, and one matching none of your hotels adds no row. At most 100 elements; a longer array returns 400.",
            "example": [
              {
                "productid": "HTL-MAJ-4711"
              },
              {
                "giata": "7654321",
                "peakworkgoalid": "864522"
              }
            ]
          },
          "HotelIDs": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "type": "string",
              "format": "uuid",
              "description": "One hotel UUID, as returned in a summary's ID field. Must be a valid, non-nil UUID.",
              "example": "0192fb17-5dc6-7abc-8def-123456789abc"
            },
            "description": "Filter to exactly these hotel UUIDs, at most 100; a longer array or an invalid or nil UUID returns 400. Duplicates are ignored, and an id outside your project is absent from Data, not an error."
          },
          "Sort": {
            "type": "string",
            "enum": [
              "feedback_activity"
            ],
            "description": "Page order: omit for the default, or 'feedback_activity' for the newest comment or reply first, hotels without feedback last; any other value or casing returns 400. Needs content.authoring:read, else 403.",
            "example": "feedback_activity"
          },
          "Limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "description": "Maximum number of items to return. Defaults to 50, or to 100 when HotelIDs is set, and is capped at 100.",
            "example": 50
          },
          "Offset": {
            "type": "integer",
            "minimum": 0,
            "default": 0,
            "description": "Number of items to skip before collecting the page. Defaults to 0.",
            "example": 0
          }
        }
      },
      "ListEnrichedHotelSummariesResponse": {
        "type": "object",
        "required": [
          "Data",
          "Pagination"
        ],
        "description": "Paginated list response wrapping the project's hotel summaries.",
        "properties": {
          "Data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EnrichedHotelSummary"
            },
            "description": "The page of enriched hotel summaries."
          },
          "Pagination": {
            "$ref": "#/components/schemas/listEnrichedHotelSummaries_Pagination"
          }
        }
      },
      "ListEnrichedHotelsRequest": {
        "type": "object",
        "description": "Request body for listing full enriched hotels. All fields are optional; omit the body to fetch the first page with default paging.",
        "properties": {
          "CountryCode": {
            "type": "string",
            "description": "Filter to hotels in this ISO 3166-1 alpha-2 country code. Omit to include all countries.",
            "example": "ES"
          },
          "Status": {
            "type": "string",
            "enum": [
              "draft",
              "active",
              "inactive",
              "closed_temporarily",
              "closed_permanently",
              "removed"
            ],
            "description": "Filter by the hotel's status in your project, one value (see `Status` on the rows). Any other value answers 400.",
            "example": "active"
          },
          "TextStatus": {
            "type": "string",
            "enum": [
              "none",
              "generating",
              "generated",
              "failed"
            ],
            "description": "Filter by your project's text state of the hotel, one value (see `TextStatus` on the rows). Any other value answers 400.",
            "example": "generated"
          },
          "IsFullyEnriched": {
            "type": "boolean",
            "description": "When true, restrict the list to hotels that have completed full enrichment.",
            "example": true
          },
          "Search": {
            "type": "string",
            "description": "Free-text search term matched against hotel name and related identity fields.",
            "example": "beach resort"
          },
          "CodeKind": {
            "type": "string",
            "description": "Filter to hotels carrying a code of this kind and surface that kind's master code. When omitted, no code-kind filter is applied and each hotel's canonical master code (or its smallest available code kind) is surfaced.",
            "example": "peakwork_master"
          },
          "TextEnrichmentStatus": {
            "type": "string",
            "deprecated": true,
            "enum": [
              "enriched",
              "enriching",
              "none"
            ],
            "description": "Deprecated: use `TextStatus`. Filter by the per-hotel generated-text state: 'enriched' (texts generated), 'enriching' (generation in progress), or 'none' (no texts yet).",
            "example": "enriched"
          },
          "TagIDs": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "Filter to hotels carrying all of these project tags, AND-combined with `TagName`. An unknown or foreign tag returns 404.",
            "example": [
              "0192fc01-1111-7abc-8def-aaaaaaaaaaaa",
              "0192fc02-2222-7abc-8def-bbbbbbbbbbbb"
            ]
          },
          "TagName": {
            "type": "string",
            "description": "Filter by a single project tag name, case-insensitive, AND-combined with `TagIDs`. An unknown name returns 404.",
            "example": "Summer Campaign"
          },
          "ExternalHotelIDs": {
            "type": "array",
            "maxItems": 50,
            "items": {
              "type": "object",
              "additionalProperties": {
                "type": "string"
              },
              "description": "One selector: `productid`, `giata` or `peakworkgoalid`, the last two positive integers as strings (`giata` up to 2147483647) or a 400. Sub-keys are AND-combined, so a hotel matches only when it matches every sub-key in it."
            },
            "description": "Filter to hotels matching any of these selectors; elements are OR-ed, sub-keys within an element AND-ed, and one matching none of your hotels adds no row. At most 50 elements; a longer array returns 400.",
            "example": [
              {
                "productid": "HTL-MAJ-4711"
              },
              {
                "giata": "7654321",
                "peakworkgoalid": "864522"
              }
            ]
          },
          "Limit": {
            "type": "integer",
            "minimum": 1,
            "default": 50,
            "description": "Maximum number of hotels to return, default 50. Because each row is a full hotel build, a higher value is clamped down to 50.",
            "example": 50
          },
          "Offset": {
            "type": "integer",
            "minimum": 0,
            "default": 0,
            "description": "Number of items to skip before collecting the page. Defaults to 0.",
            "example": 0
          }
        }
      },
      "ListEnrichedHotelsResponse": {
        "type": "object",
        "required": [
          "Data",
          "Pagination"
        ],
        "description": "Paginated list response wrapping the full enriched hotels.",
        "properties": {
          "Data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/listEnrichedHotels_EnrichedHotel"
            },
            "description": "The page of full enriched hotels (at most 50 per page)."
          },
          "Pagination": {
            "$ref": "#/components/schemas/listEnrichedHotels_Pagination"
          }
        }
      },
      "ListTagsRequest": {
        "type": "object",
        "description": "No request body is required for listing tags. The project is taken from the X-Project-ID header / authorized scope.",
        "properties": {}
      },
      "ListTagsResponse": {
        "type": "object",
        "required": [
          "Data"
        ],
        "description": "Response envelope wrapping the project's tags as a plain array (not paginated).",
        "properties": {
          "Data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ProjectTag"
            },
            "description": "The project's internal tags."
          }
        }
      },
      "ListTextTemplatesRequest": {
        "type": "object",
        "description": "Request body for listing text templates. All fields are optional; an empty body returns the first page of all templates.",
        "properties": {
          "Status": {
            "type": "string",
            "enum": [
              "active",
              "inactive"
            ],
            "description": "Filter by lifecycle status. When omitted, templates of every status are returned.",
            "example": "active"
          },
          "EntityType": {
            "type": "string",
            "enum": [
              "hotel",
              "room"
            ],
            "description": "Filter by the entity a template targets: 'hotel' for hotel-level texts, 'room' for room-level texts. When omitted, both kinds are returned.",
            "example": "hotel"
          },
          "IncludeStats": {
            "type": "boolean",
            "description": "When true, each returned template includes a UsageStats object summarizing how many generated texts use it. Defaults to false.",
            "example": false
          },
          "Limit": {
            "type": "integer",
            "minimum": 1,
            "maximum": 100,
            "default": 50,
            "description": "Maximum number of templates to return. Defaults to 50 and is capped at 100.",
            "example": 50
          },
          "Offset": {
            "type": "integer",
            "minimum": 0,
            "default": 0,
            "description": "Number of templates to skip for pagination. Defaults to 0.",
            "example": 0
          }
        }
      },
      "ListTextTemplatesResponse": {
        "type": "object",
        "required": [
          "Data",
          "Pagination"
        ],
        "description": "Paginated list response wrapping the project's text templates.",
        "properties": {
          "Data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TextTemplate"
            },
            "description": "The text templates for this page, ordered by template key."
          },
          "Pagination": {
            "$ref": "#/components/schemas/listTextTemplates_Pagination"
          }
        }
      },
      "ListVisionImage": {
        "type": "object",
        "required": [
          "ImageID",
          "URL",
          "Status",
          "SubmittedAt",
          "BatchID",
          "HotelID"
        ],
        "description": "One submitted image: its state, when and how it was submitted, and the enriched image object once the analysis is complete.",
        "properties": {
          "ImageID": {
            "type": "string",
            "format": "uuid",
            "description": "Image UUID, the same ID ingestVisionImages returned and getVisionImages polls.",
            "example": "0199b2c4-8e31-77aa-9c02-3f5b71a2d9e4"
          },
          "URL": {
            "type": "string",
            "format": "uri",
            "description": "The submitted image URL, normalized.",
            "example": "https://ucarecdn.com/3f0a1d55-8b2c-4e79-9d64-7a1c2b3d4e5f/"
          },
          "Status": {
            "type": "string",
            "enum": [
              "pending",
              "completed",
              "failed"
            ],
            "description": "Analysis state: `pending` still being analyzed, `completed` `Image` carries the result, `failed` the URL could not be fetched. `not_found` never appears here.",
            "example": "completed"
          },
          "SubmittedAt": {
            "type": "string",
            "format": "date-time",
            "description": "RFC 3339 timestamp of the submission. It is the sort key, descending; re-submitting the same URL refreshes it, which moves the image back to the top of the list.",
            "example": "2026-09-09T16:04:12.550118Z"
          },
          "BatchID": {
            "type": "string",
            "format": "uuid",
            "description": "Identifier shared by every image submitted in the same ingestVisionImages request.",
            "example": "0199b2c4-8e30-7b19-9a4d-2e7f6c1b8d33"
          },
          "HotelID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the hotel this image is stored under.",
            "example": "01a086e1-ffaf-7040-b032-76677278f0ae"
          },
          "HotelName": {
            "type": "string",
            "description": "Name of that hotel. Present for the placeholder hotel and for hotels that belong to your project, omitted otherwise.",
            "example": "Vision AI API placeholder"
          },
          "IsPlaceholderHotel": {
            "type": "boolean",
            "description": "True when the image was submitted without a hotel and therefore sits on the project's placeholder hotel. Present only when it is true; omitted for an image submitted for a hotel.",
            "example": true
          },
          "RoomRef": {
            "type": "string",
            "description": "The room code or name submitted with this image. Omitted when the image was submitted without one.",
            "example": "DBL-SEA"
          },
          "Image": {
            "allOf": [
              {
                "$ref": "#/components/schemas/listVisionImages_Image"
              }
            ],
            "description": "The enriched image object. Present only when Status is `completed`."
          }
        }
      },
      "ListVisionImagesRequest": {
        "type": "object",
        "description": "Filter and page this project's submitted images. Every field is optional, so an empty body `{}` returns the first page of every image the project has submitted.",
        "properties": {
          "Status": {
            "type": "string",
            "enum": [
              "pending",
              "completed",
              "failed"
            ],
            "description": "Restrict the list to one state; omit it to list every state. A filter covers your newest 10,000 submissions.",
            "example": "completed"
          },
          "Limit": {
            "type": "integer",
            "default": 50,
            "description": "Page size. Defaults to 50 when omitted or 0; a value above 100 is reduced to 100 rather than refused.",
            "example": 50
          },
          "Offset": {
            "type": "integer",
            "default": 0,
            "description": "Number of images to skip before this page, default 0. An offset past the last image returns an empty page.",
            "example": 0
          }
        }
      },
      "ListVisionImagesResponse": {
        "type": "object",
        "required": [
          "Data",
          "Pagination"
        ],
        "description": "List response envelope: Data is the page of submitted images and Pagination describes the whole matching set.",
        "properties": {
          "Data": {
            "type": "array",
            "description": "The page of submitted images, newest first. Always an array: an empty page is [] and never null.",
            "items": {
              "$ref": "#/components/schemas/ListVisionImage"
            }
          },
          "Pagination": {
            "$ref": "#/components/schemas/listVisionImages_Pagination"
          }
        }
      },
      "Location": {
        "type": "object",
        "required": [
          "Latitude",
          "Longitude",
          "CountryCode"
        ],
        "description": "Geographic location of the hotel.",
        "properties": {
          "Latitude": {
            "type": "number",
            "format": "double",
            "description": "Latitude in decimal degrees.",
            "example": 39.5696
          },
          "Longitude": {
            "type": "number",
            "format": "double",
            "description": "Longitude in decimal degrees.",
            "example": 2.6502
          },
          "CountryCode": {
            "type": "string",
            "description": "ISO 3166-1 alpha-2 country code.",
            "example": "ES"
          },
          "Address": {
            "$ref": "#/components/schemas/Address"
          }
        }
      },
      "NearestPOI": {
        "type": "object",
        "required": [
          "Type",
          "Distance",
          "Unit"
        ],
        "description": "The nearest point of interest of one type and its distance from the hotel. POI data partly © OpenStreetMap contributors, available under the ODbL.",
        "properties": {
          "Type": {
            "type": "string",
            "description": "POI category, currently `beach` or `airport`; more types may be added.",
            "example": "beach"
          },
          "Distance": {
            "type": "number",
            "format": "double",
            "description": "Distance in Unit: meters below 1 km, else km to one decimal. 0 with Unit `m` when the hotel lies inside the area, for a beach on its sand.",
            "example": 350
          },
          "Unit": {
            "type": "string",
            "enum": [
              "m",
              "km"
            ],
            "description": "Unit for Distance: `m` for meters (below 1 km), `km` for kilometers.",
            "example": "m"
          }
        }
      },
      "POI": {
        "type": "object",
        "required": [
          "ID",
          "Name",
          "Type"
        ],
        "description": "A nearby point of interest: one place, or an area (IsArea) such as part of a town or a beach. POI data partly © OpenStreetMap contributors, available under the ODbL.",
        "properties": {
          "ID": {
            "type": "string",
            "format": "uuid",
            "description": "Unique POI UUID. Stable identifier used as the entity id when submitting feedback about this POI.",
            "example": "0192fb20-1aa2-7def-9abc-1122334455aa"
          },
          "Name": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Localized POI names keyed by BCP 47 language tag, always with en-US. For an area (IsArea true) it is the area's official local name, translated per locale.",
            "example": {
              "en-US": "Palma Cathedral",
              "de-DE": "Kathedrale von Palma"
            }
          },
          "Type": {
            "type": "string",
            "description": "POI category (e.g. landmark, beach, airport, restaurant).",
            "example": "landmark"
          },
          "Distance": {
            "type": "number",
            "format": "double",
            "description": "Distance in Unit: meters under 1 km, else km to one decimal; for an area, to its nearest edge, its centre without an outline, or the distance its source stated. Omitted with Unit when unknown, at the hotel or InArea.",
            "example": 3.2
          },
          "Unit": {
            "type": "string",
            "enum": [
              "m",
              "km"
            ],
            "description": "Unit for Distance: m for meters, km for kilometers. Present exactly when Distance is present.",
            "example": "km"
          },
          "IsArea": {
            "type": "boolean",
            "description": "True for a POI that is an area rather than one place: an area of a town (a historic centre, an old town, a district, a promenade), or a beach located by its OpenStreetMap outline. Omitted when false.",
            "example": true
          },
          "InArea": {
            "type": "boolean",
            "description": "True when the hotel lies inside the area's outline, for a beach on its sand; Distance and Unit are then omitted. Implies IsArea; not set when a stated distance is kept, omitted when false.",
            "example": true
          },
          "Latitude": {
            "type": "number",
            "format": "double",
            "description": "Latitude of the POI in decimal degrees (WGS-84). For an area (IsArea) it is the area's representative point: the centroid of its outline, which can lie off a line or an irregular area, or its single point. Sent together with Longitude; both are omitted when the POI has no known position, an area that could not be located included.",
            "example": 39.5675
          },
          "Longitude": {
            "type": "number",
            "format": "double",
            "description": "Longitude of the POI in decimal degrees (WGS-84). Present exactly when Latitude is present.",
            "example": 2.6484
          },
          "Details": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Additional POI properties. Omitted when empty."
          }
        }
      },
      "Pagination": {
        "type": "object",
        "required": [
          "Total",
          "Limit",
          "Offset"
        ],
        "description": "Pagination info for the list.",
        "properties": {
          "Total": {
            "type": "integer",
            "description": "Total number of links matching the request, ignoring Limit and Offset. It counts exactly the links this endpoint lists, so links revoked before their hotel approved are excluded from it too.",
            "example": 2
          },
          "Limit": {
            "type": "integer",
            "description": "Page size actually applied.",
            "example": 100
          },
          "Offset": {
            "type": "integer",
            "description": "Offset actually applied.",
            "example": 0
          }
        }
      },
      "PresenceDetection": {
        "type": "object",
        "required": [
          "Label",
          "Confidence"
        ],
        "description": "One person or animal seen in the image.",
        "properties": {
          "Label": {
            "type": "string",
            "description": "What was seen: `person`, `adult`, `child` or `animal`.",
            "example": "adult"
          },
          "Confidence": {
            "$ref": "#/components/schemas/DetectionConfidence"
          }
        }
      },
      "PreviewChange": {
        "type": "object",
        "required": [
          "Category",
          "CompletedAt"
        ],
        "description": "One source category that was refreshed more recently than the hotel's stored text.",
        "properties": {
          "Category": {
            "type": "string",
            "enum": [
              "attributes",
              "POIs",
              "images"
            ],
            "description": "Source data category that changed.",
            "example": "attributes"
          },
          "CompletedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Completion timestamp of the latest run that refreshed this category (RFC3339).",
            "example": "2026-06-25T14:02:00Z"
          }
        }
      },
      "PreviewHotel": {
        "type": "object",
        "required": [
          "HotelID",
          "HotelName",
          "Texts",
          "WhatChanged",
          "TextsToGenerate"
        ],
        "description": "The preview for a single hotel: its per-template-and-locale text statuses, its what-changed summary, and how many texts would be generated for it under fill_missing.",
        "properties": {
          "HotelID": {
            "type": "string",
            "format": "uuid",
            "description": "Hotel UUID.",
            "example": "0192fb17-5dc6-7abc-8def-123456789abc"
          },
          "HotelName": {
            "type": "string",
            "description": "Hotel display name.",
            "example": "Bahia Azul Beach Resort"
          },
          "Texts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PreviewText"
            },
            "description": "Per (template, locale) freshness status rows for this hotel."
          },
          "WhatChanged": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PreviewChange"
            },
            "description": "Source categories that were refreshed more recently than this hotel's stored text, ordered deterministically. Empty when nothing newer changed."
          },
          "TextsToGenerate": {
            "type": "integer",
            "description": "Number of texts this hotel would (re)generate under fill_missing.",
            "example": 5
          }
        }
      },
      "PreviewResult": {
        "type": "object",
        "required": [
          "Hotels",
          "TotalTextsToGenerate"
        ],
        "description": "The full preview: one entry per selected hotel plus the grand total of texts that would be generated under fill_missing.",
        "properties": {
          "Hotels": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PreviewHotel"
            },
            "description": "One preview entry per selected hotel, in the resolved selection order."
          },
          "TotalTextsToGenerate": {
            "type": "integer",
            "description": "Total number of texts across all hotels that a fill_missing run would (re)generate.",
            "example": 5
          }
        }
      },
      "PreviewText": {
        "type": "object",
        "required": [
          "TemplateKey",
          "EntityType",
          "Locale",
          "Status",
          "Count"
        ],
        "description": "The freshness status of one (template, locale) pair for a hotel. For room templates the status aggregates across the hotel's active rooms (worst-case: missing beats stale beats fresh) and Count is the number of room texts that would be generated.",
        "properties": {
          "TemplateKey": {
            "type": "string",
            "description": "Template key this row refers to.",
            "example": "Summary"
          },
          "EntityType": {
            "type": "string",
            "enum": [
              "hotel",
              "room"
            ],
            "description": "Whether this template applies to the hotel or to its rooms.",
            "example": "hotel"
          },
          "Locale": {
            "type": "string",
            "description": "BCP 47 language tag this row refers to.",
            "example": "de-DE"
          },
          "Status": {
            "type": "string",
            "enum": [
              "missing",
              "fresh",
              "stale"
            ],
            "description": "Freshness of the stored text for this (template, locale) pair: 'missing' (not generated yet), 'fresh' (up to date), or 'stale' (generated before its source data last changed).",
            "example": "missing"
          },
          "Count": {
            "type": "integer",
            "description": "Number of underlying texts this row represents that would be generated under fill_missing. For hotel templates it is 0 or 1; for room templates it is the per-room text total.",
            "example": 1
          }
        }
      },
      "PreviewTextRequest": {
        "type": "object",
        "description": "Request body for previewing a text-generation run. At least one of HotelIDs or TagIDs must be provided. HotelIDs and the hotels resolved from TagIDs are combined and deduplicated; the result is capped at 100 hotels.",
        "properties": {
          "HotelIDs": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "Explicit hotel UUIDs to preview. Each hotel must belong to the calling project; a hotel outside the project's scope returns 404. Required if TagIDs is empty.",
            "example": [
              "0192fb17-5dc6-7abc-8def-123456789abc"
            ]
          },
          "TagIDs": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "Tag UUIDs. Hotels carrying ALL of the given tags (intersection) and belonging to the project are added to the selection. Required if HotelIDs is empty.",
            "example": [
              "0192fb40-7aa1-7abc-8def-aabbccddeeff"
            ]
          },
          "TemplateKeys": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Optional subset of active template keys to preview. Each key must be an active template of the project. Empty means all active templates. Maximum 100 keys.",
            "example": [
              "Summary",
              "HouseRules"
            ]
          },
          "Locales": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Optional subset of BCP 47 language tags to preview. Empty means the locales configured on the matched templates (always including en-US).",
            "example": [
              "en-US",
              "de-DE"
            ]
          }
        }
      },
      "PreviewTextResponse": {
        "type": "object",
        "required": [
          "Data"
        ],
        "description": "Single-object response envelope wrapping the preview result.",
        "properties": {
          "Data": {
            "$ref": "#/components/schemas/PreviewResult"
          }
        }
      },
      "ProjectTag": {
        "type": "object",
        "required": [
          "ID",
          "ProjectID",
          "Name",
          "CreatedBy"
        ],
        "description": "A project-private internal tag.",
        "properties": {
          "ID": {
            "type": "string",
            "format": "uuid",
            "description": "Unique tag UUID.",
            "example": "0192fc01-1111-7abc-8def-aaaaaaaaaaaa"
          },
          "ProjectID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the project that owns the tag.",
            "example": "0192fa00-0000-7abc-8def-000000000000"
          },
          "Name": {
            "type": "string",
            "description": "Tag display name.",
            "example": "Summer Campaign"
          },
          "CreatedBy": {
            "type": "string",
            "description": "Audit identity of who created the tag: a user token records the user's email; a project (proj_) machine token records its project-scoped identity (e.g. 'project:<project-uuid>').",
            "example": "editor@example.com"
          }
        }
      },
      "ProjectTagSummary": {
        "type": "object",
        "required": [
          "ID",
          "Name"
        ],
        "description": "A reference to one internal tag of your project's content set applied to the hotel: the tag id, display name and optional description.",
        "properties": {
          "ID": {
            "type": "string",
            "format": "uuid",
            "description": "Unique project tag UUID.",
            "example": "0192fc01-1111-7abc-8def-aaaaaaaaaaaa"
          },
          "Name": {
            "type": "string",
            "description": "Tag display name.",
            "example": "Summer Campaign"
          },
          "Description": {
            "type": "string",
            "description": "Tag description. Omitted when the tag has none.",
            "example": "Hotels in the 2026 summer campaign"
          }
        }
      },
      "RejectApprovalImageUploadRequest": {
        "type": "object",
        "required": [
          "HotelID",
          "FeedbackID"
        ],
        "description": "The upload to reject and its hotel.",
        "properties": {
          "HotelID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the hotel. Required, a valid non-nil UUID, and a live member of the calling project.",
            "example": "019d9c2e-0ef8-7458-b0fa-8bed7182eb30"
          },
          "FeedbackID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the upload: its `ID` from listApprovalImageUploads, the id of its feedback item. Required, a valid non-nil UUID.",
            "example": "01a0f1c9-3e8a-7c12-b4d5-8e9f0a1b2c3d"
          }
        }
      },
      "RejectApprovalImageUploadResponse": {
        "type": "object",
        "required": [
          "Data"
        ],
        "description": "Single-object response envelope wrapping the decided upload.",
        "properties": {
          "Data": {
            "$ref": "#/components/schemas/ApprovalImageUpload"
          }
        }
      },
      "RemoveTagFromHotelsRequest": {
        "type": "object",
        "required": [
          "TagID",
          "HotelIDs"
        ],
        "description": "Request body for bulk-removing a tag from hotels.",
        "properties": {
          "TagID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the project tag to remove. Must be a valid, non-nil UUID belonging to the calling project; a foreign tag returns 404.",
            "example": "0192fc01-1111-7abc-8def-aaaaaaaaaaaa"
          },
          "HotelIDs": {
            "type": "array",
            "minItems": 1,
            "maxItems": 1000,
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "description": "Hotel UUIDs to untag. Must contain between 1 and 1000 ids. Each id is validated individually; a malformed id is reported 'invalid' in the per-hotel results rather than failing the whole request. Removing a link that does not exist is a no-op.",
            "example": [
              "0192fb17-5dc6-7abc-8def-123456789abc",
              "0192fb18-6ed7-7abc-8def-223456789abc"
            ]
          }
        }
      },
      "RemoveTagFromHotelsResponse": {
        "type": "object",
        "required": [
          "Data"
        ],
        "description": "Single-object response envelope wrapping the bulk remove outcome.",
        "properties": {
          "Data": {
            "$ref": "#/components/schemas/removeTagFromHotels_BulkTagResult"
          }
        }
      },
      "RevokeApprovalLinkRequest": {
        "type": "object",
        "required": [
          "HotelID"
        ],
        "description": "The hotel whose link should be revoked.",
        "properties": {
          "HotelID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the hotel. Required, a valid non-nil UUID, and a live member of the calling project.",
            "example": "019d9c2e-0ef8-7458-b0fa-8bed7182eb30"
          }
        }
      },
      "RevokeApprovalLinkResponse": {
        "type": "object",
        "required": [
          "Data"
        ],
        "description": "Single-object response envelope wrapping the revoked link.",
        "properties": {
          "Data": {
            "$ref": "#/components/schemas/revokeApprovalLink_ApprovalLink"
          }
        }
      },
      "RotateApprovalLinkRequest": {
        "type": "object",
        "required": [
          "HotelID"
        ],
        "description": "The hotel whose link token should be replaced.",
        "properties": {
          "HotelID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the hotel. Required, a valid non-nil UUID, and a live member of the calling project.",
            "example": "019d9c2e-0ef8-7458-b0fa-8bed7182eb30"
          }
        }
      },
      "RotateApprovalLinkResponse": {
        "type": "object",
        "required": [
          "Data"
        ],
        "description": "Single-object response envelope wrapping the rotated link.",
        "properties": {
          "Data": {
            "$ref": "#/components/schemas/ApprovalLink"
          }
        }
      },
      "RunProgress": {
        "type": "object",
        "required": [
          "Total",
          "Generated",
          "Failed",
          "Skipped"
        ],
        "description": "Per-hotel progress counters for the run.",
        "properties": {
          "Total": {
            "type": "integer",
            "description": "Total number of hotels in the run.",
            "example": 2
          },
          "Generated": {
            "type": "integer",
            "description": "Number of hotels for which text has been generated so far.",
            "example": 0
          },
          "Failed": {
            "type": "integer",
            "description": "Number of hotels that failed processing.",
            "example": 0
          },
          "Skipped": {
            "type": "integer",
            "description": "Number of hotels skipped because they needed no work.",
            "example": 0
          }
        }
      },
      "SaveHotelImagePinRequest": {
        "type": "object",
        "required": [
          "HotelID",
          "ImageID"
        ],
        "description": "Request body for pinning a hotel image. Both ids are required, valid, non-nil UUIDs.",
        "properties": {
          "HotelID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the hotel to pin an image for. The hotel must belong to the calling project; a hotel outside the project's scope returns 404.",
            "example": "0192fb17-5dc6-7abc-8def-123456789abc"
          },
          "ImageID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the image to pin. The image must belong to the hotel (404 otherwise) and be active (400 otherwise). A room-level image can be pinned only while the hotel has no hotel-level images (400 otherwise).",
            "example": "0192fb20-1aa2-7def-9abc-1122334455aa"
          }
        }
      },
      "SaveHotelImagePinResponse": {
        "type": "object",
        "required": [
          "Data"
        ],
        "description": "Single-object response envelope wrapping the saved pin.",
        "properties": {
          "Data": {
            "$ref": "#/components/schemas/HotelImagePin"
          }
        }
      },
      "SaveHotelStarsRequest": {
        "type": "object",
        "required": [
          "HotelID",
          "Stars"
        ],
        "description": "Request body for setting your project's star grade for a hotel. A project grade has no Superior: a body with Superior set to `true` or `false` is refused with 400 (`null` counts as absent).",
        "properties": {
          "HotelID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the hotel to grade. The hotel must belong to the calling project; a hotel outside the project's scope returns 404.",
            "example": "0192fb17-5dc6-7abc-8def-123456789abc"
          },
          "Stars": {
            "type": "number",
            "format": "float",
            "minimum": 0,
            "exclusiveMinimum": true,
            "maximum": 10,
            "description": "Your project's grade for the hotel: greater than 0 and at most 10, with at most one decimal (for example 4 or 4.5). A missing value reads as 0 and is refused.",
            "example": 4.5
          }
        }
      },
      "SaveHotelStarsResponse": {
        "type": "object",
        "required": [
          "Data"
        ],
        "description": "Single-object response envelope wrapping the saved grade.",
        "properties": {
          "Data": {
            "$ref": "#/components/schemas/HotelStars"
          }
        }
      },
      "SaveTagRequest": {
        "type": "object",
        "required": [
          "Name"
        ],
        "description": "Request body for creating or renaming a project tag.",
        "properties": {
          "TagID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of an existing tag to rename. Omit (or send empty) to create a new tag. When supplied it must be a valid, non-nil UUID belonging to the calling project; a tag id not in the project returns 404.",
            "example": "0192fc01-1111-7abc-8def-aaaaaaaaaaaa"
          },
          "Name": {
            "type": "string",
            "description": "Tag display name. Required, non-empty after trimming, and unique within the project (case-insensitive). Capped at 200 Unicode characters.",
            "example": "Summer Campaign"
          }
        }
      },
      "SaveTagResponse": {
        "type": "object",
        "required": [
          "Data"
        ],
        "description": "Single-object response envelope wrapping the saved tag.",
        "properties": {
          "Data": {
            "$ref": "#/components/schemas/ProjectTag"
          }
        }
      },
      "SaveTextTemplateRequest": {
        "type": "object",
        "required": [
          "TemplateKey",
          "EntityType",
          "Instruction"
        ],
        "description": "Request body for creating or updating a text template. The template is matched within the project by TemplateKey.",
        "properties": {
          "TemplateKey": {
            "type": "string",
            "maxLength": 100,
            "description": "Stable key identifying the template within the project (max 100 characters). The generated text for this template is stored under this key (e.g. 'summary', 'room_description'). A key may be namespaced with a leading 'group.' prefix to define a variant within a template group. Saving with an existing key updates that template; a new key creates one.",
            "example": "summary"
          },
          "Name": {
            "type": "string",
            "description": "Human-readable template name for display. Optional.",
            "example": "Hotel Summary"
          },
          "EntityType": {
            "type": "string",
            "enum": [
              "hotel",
              "room"
            ],
            "description": "Whether the template produces a hotel-level text or a room-level text.",
            "example": "hotel"
          },
          "Description": {
            "type": "string",
            "description": "Free-text note describing what the template is for. Optional.",
            "example": "Short marketing summary shown at the top of the hotel page."
          },
          "Instruction": {
            "type": "string",
            "maxLength": 12000,
            "description": "Default authoring instruction that guides text generation when no locale-specific override applies. Required. Limited to 12,000 characters (Unicode characters, not bytes); longer instructions are rejected.",
            "example": "Write a concise, factual two-sentence summary highlighting the hotel's location, standout amenity, and overall character. Avoid superlatives."
          },
          "LocaleInstructions": {
            "type": "object",
            "maxProperties": 100,
            "additionalProperties": {
              "type": "string",
              "maxLength": 2500
            },
            "description": "Per-locale authoring instructions keyed by BCP 47 language tag (e.g. 'de-DE'). When a locale has an entry here, it overrides the default Instruction for that locale; otherwise the default Instruction is used. Optional; omit or pass an empty object for no overrides. Each per-locale instruction is limited to 2,500 characters, counted independently of the base instruction, and a template carries at most 100 locale entries.",
            "example": {
              "de-DE": "Schreibe eine sachliche Zusammenfassung in zwei Saetzen und verwende die Sie-Form."
            }
          },
          "Status": {
            "type": "string",
            "enum": [
              "active",
              "inactive"
            ],
            "description": "Lifecycle status. Only 'active' templates are used during text generation. Defaults to 'active' when omitted.",
            "example": "active"
          },
          "RenderLayout": {
            "type": "string",
            "enum": [
              "prose",
              "highlights",
              "roomcards",
              "summary"
            ],
            "description": "Optional rendering hint suggesting how a client should display this template's generated text. Leave empty or omit when no hint is needed.",
            "example": "prose"
          }
        }
      },
      "SaveTextTemplateResponse": {
        "type": "object",
        "required": [
          "Data"
        ],
        "description": "Single-object response envelope wrapping the saved text template.",
        "properties": {
          "Data": {
            "$ref": "#/components/schemas/saveTextTemplate_TextTemplate"
          }
        }
      },
      "StarsMap": {
        "type": "object",
        "description": "Grades by source, in default's order: project (content set's, if set), national, association, canonical (own site); new keys may appear. default is always present: the first one set, else the collected rating or 0.",
        "additionalProperties": {
          "$ref": "#/components/schemas/StarsMapEntry"
        }
      },
      "StarsMapEntry": {
        "type": "object",
        "required": [
          "Stars",
          "Superior",
          "Garni"
        ],
        "description": "One star grade from one source, or the computed default. Stars, Superior and Garni are always present; further members may be added, so ignore members you do not read.",
        "properties": {
          "Stars": {
            "type": "number",
            "format": "float",
            "minimum": 0,
            "maximum": 10,
            "description": "The grade (for example 4 or 4.5), with at most one decimal except a default taken from the collected rating. Only default may be 0 (unrated), and default.Stars always equals the top-level Stars.",
            "example": 4
          },
          "Superior": {
            "type": "boolean",
            "description": "True when the grade is a Superior class on top of Stars, such as the \"S\" suffix of a national classification; a \"4 Superior\" is Stars 4 with Superior true, never 4.5. False when the source sets no Superior.",
            "example": true
          },
          "Garni": {
            "type": "boolean",
            "description": "True when the source classifies the hotel as a garni, a hotel that serves breakfast but no other meals, such as the \"Garni\" suffix of a national classification. False when the source sets no Garni.",
            "example": false
          }
        }
      },
      "SummaryGeneratedTexts": {
        "type": "object",
        "additionalProperties": {
          "type": "object",
          "required": [
            "Summary"
          ],
          "properties": {
            "Summary": {
              "$ref": "#/components/schemas/GeneratedTextDetail"
            }
          }
        }
      },
      "SummaryImage": {
        "type": "object",
        "required": [
          "URL",
          "Width",
          "Height",
          "BlurHash"
        ],
        "description": "One image of a hotel row: its URL, size and BlurHash placeholder.",
        "properties": {
          "URL": {
            "type": "string",
            "format": "uri",
            "description": "Image URL.",
            "example": "https://cdn.ygo.ai/hotels/bahia-azul/exterior-pool.jpg"
          },
          "Width": {
            "type": "integer",
            "description": "Image width in pixels.",
            "example": 1600
          },
          "Height": {
            "type": "integer",
            "description": "Image height in pixels.",
            "example": 1067
          },
          "BlurHash": {
            "type": "string",
            "description": "BlurHash placeholder string for progressive loading. Empty when the image has none.",
            "example": "LKO2?U%2Tw=w]~RBVZRi};RPxuwH"
          }
        }
      },
      "TemplateUsageStats": {
        "type": "object",
        "description": "Aggregated usage counts for a template, included only when IncludeStats is true in the request.",
        "properties": {
          "TextCount": {
            "type": "integer",
            "description": "Total number of generated texts that use this template across the project.",
            "example": 1240
          },
          "HotelCount": {
            "type": "integer",
            "description": "Number of distinct hotels that have at least one generated text from this template.",
            "example": 620
          },
          "LastGeneratedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true,
            "description": "Timestamp of the most recent text generated from this template (RFC3339). Null when the template has never been used.",
            "example": "2026-04-12T09:15:00Z"
          }
        }
      },
      "TextDetection": {
        "type": "object",
        "required": [
          "Content",
          "Label",
          "Confidence"
        ],
        "description": "One text read off the image.",
        "properties": {
          "Content": {
            "type": "string",
            "description": "The text as it appears on the image. A password or access code printed after a password label is masked.",
            "example": "POOL BAR"
          },
          "Label": {
            "type": "string",
            "description": "Kind of text: `overlay`, `price`, `promotional`, `watermark`, `signage` or `document`.",
            "example": "signage"
          },
          "Confidence": {
            "$ref": "#/components/schemas/DetectionConfidence"
          }
        }
      },
      "TextGenerationRun": {
        "type": "object",
        "required": [
          "ID",
          "Status",
          "Progress",
          "CreatedAt",
          "UpdatedAt"
        ],
        "description": "A text-generation run with its own status and progress.",
        "properties": {
          "ID": {
            "type": "string",
            "format": "uuid",
            "description": "Unique run UUID. Pass this to getTextGenerationStatus to poll the run.",
            "example": "0192fb50-8bb2-7abc-8def-112233445566"
          },
          "Status": {
            "type": "string",
            "enum": [
              "queued",
              "processing",
              "complete",
              "failed"
            ],
            "description": "Run lifecycle status. A freshly created run is 'queued'; it transitions to 'processing' while running, then to 'complete' or 'failed'.",
            "example": "queued"
          },
          "Progress": {
            "$ref": "#/components/schemas/RunProgress"
          },
          "ErrorMessage": {
            "type": "string",
            "description": "Human-readable error message when the run has failed. Empty or omitted otherwise.",
            "example": ""
          },
          "StartedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the run started processing (RFC3339). Omitted until the run has started.",
            "example": "2026-06-26T09:15:05Z"
          },
          "CompletedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the run finished (RFC3339). Omitted until the run has finished.",
            "example": "2026-06-26T09:17:30Z"
          },
          "CreatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the run record was created (RFC3339).",
            "example": "2026-06-26T09:15:00Z"
          },
          "UpdatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the run record was last updated (RFC3339).",
            "example": "2026-06-26T09:15:00Z"
          }
        }
      },
      "TextGenerationStatus": {
        "type": "object",
        "required": [
          "ID",
          "Status",
          "Progress",
          "CreatedAt",
          "UpdatedAt"
        ],
        "description": "The status and progress of a text-generation run.",
        "properties": {
          "ID": {
            "type": "string",
            "format": "uuid",
            "description": "Unique run UUID.",
            "example": "0192fb50-8bb2-7abc-8def-112233445566"
          },
          "Status": {
            "type": "string",
            "enum": [
              "queued",
              "processing",
              "complete",
              "failed"
            ],
            "description": "Run lifecycle status. A freshly created run is 'queued'; it transitions to 'processing' while running, then to 'complete' or 'failed'.",
            "example": "processing"
          },
          "Progress": {
            "$ref": "#/components/schemas/getTextGenerationStatus_RunProgress"
          },
          "ErrorMessage": {
            "type": "string",
            "description": "Human-readable error message when the run has failed. Empty or omitted otherwise.",
            "example": ""
          },
          "StartedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the run started processing (RFC3339). Omitted until the run has started.",
            "example": "2026-06-26T09:15:05Z"
          },
          "CompletedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the run finished (RFC3339). Omitted until the run has finished.",
            "example": "2026-06-26T09:18:42Z"
          },
          "CreatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the run record was created (RFC3339).",
            "example": "2026-06-26T09:15:00Z"
          },
          "UpdatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the run record was last updated (RFC3339).",
            "example": "2026-06-26T09:16:10Z"
          }
        }
      },
      "TextTemplate": {
        "type": "object",
        "required": [
          "ID",
          "ProjectID",
          "TemplateKey",
          "EntityType",
          "Instruction",
          "LocaleInstructions",
          "Status",
          "CreatedAt",
          "UpdatedAt"
        ],
        "description": "A project-scoped text template. It controls one generated text per locale for either a hotel or a room, using a default authoring instruction plus optional per-locale instruction overrides.",
        "properties": {
          "ID": {
            "type": "string",
            "format": "uuid",
            "description": "Unique template UUID.",
            "example": "0192fb40-1aa2-7def-9abc-1122334455aa"
          },
          "ProjectID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the project that owns this template.",
            "example": "0192fb00-0000-7000-8000-000000000001"
          },
          "TemplateKey": {
            "type": "string",
            "description": "Stable key identifying the template within the project. The generated text for this template is stored under this key (e.g. 'summary', 'room_description'). A key may be namespaced with a leading 'group.' prefix to define a variant within a template group.",
            "example": "summary"
          },
          "Name": {
            "type": "string",
            "description": "Human-readable template name for display. May be empty.",
            "example": "Hotel Summary"
          },
          "EntityType": {
            "type": "string",
            "enum": [
              "hotel",
              "room"
            ],
            "description": "Whether the template produces a hotel-level text or a room-level text.",
            "example": "hotel"
          },
          "Description": {
            "type": "string",
            "description": "Free-text note describing what the template is for. May be empty.",
            "example": "Short marketing summary shown at the top of the hotel page."
          },
          "Instruction": {
            "type": "string",
            "description": "Default authoring instruction that guides text generation when no locale-specific override applies.",
            "example": "Write a concise, factual two-sentence summary highlighting the hotel's location, standout amenity, and overall character. Avoid superlatives."
          },
          "LocaleInstructions": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Per-locale authoring instructions keyed by BCP 47 language tag (e.g. 'de-DE'). When a locale has an entry here, it overrides the default Instruction for that locale; otherwise the default Instruction is used. An empty object means no per-locale overrides.",
            "example": {
              "de-DE": "Schreibe eine sachliche Zusammenfassung in zwei Saetzen und verwende die Sie-Form."
            }
          },
          "Status": {
            "type": "string",
            "enum": [
              "active",
              "inactive"
            ],
            "description": "Lifecycle status. Only 'active' templates are used during text generation.",
            "example": "active"
          },
          "RenderLayout": {
            "type": "string",
            "enum": [
              "prose",
              "highlights",
              "roomcards",
              "summary"
            ],
            "description": "Optional rendering hint suggesting how a client should display this template's generated text. Empty when no hint is set.",
            "example": "prose"
          },
          "UsageStats": {
            "$ref": "#/components/schemas/TemplateUsageStats"
          },
          "CreatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the template was created (RFC3339).",
            "example": "2026-03-01T08:00:00Z"
          },
          "UpdatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the template was last updated (RFC3339).",
            "example": "2026-04-10T12:30:00Z"
          }
        }
      },
      "VisionImageState": {
        "type": "object",
        "required": [
          "ImageID",
          "Status"
        ],
        "description": "The analysis state of one polled image, with the enriched image object once the analysis is complete.",
        "properties": {
          "ImageID": {
            "type": "string",
            "format": "uuid",
            "description": "The requested image UUID.",
            "example": "0192fb21-2bb3-7def-9abc-2233445566bb"
          },
          "Status": {
            "type": "string",
            "enum": [
              "pending",
              "completed",
              "failed",
              "not_found"
            ],
            "description": "Analysis state: `pending` keep polling, `completed` `Image` carries the result, `failed` stop polling and submit a working URL, `not_found` the ID is unknown for this project.",
            "example": "completed"
          },
          "RoomRef": {
            "type": "string",
            "description": "The room code or name submitted with this image. Omitted when the image was submitted without one.",
            "example": "DBL-SEA"
          },
          "Image": {
            "allOf": [
              {
                "$ref": "#/components/schemas/getVisionImages_Image"
              }
            ],
            "description": "The enriched image object. Present only when Status is `completed`."
          }
        }
      },
      "VisionImageSubmission": {
        "type": "object",
        "required": [
          "URL"
        ],
        "description": "One image URL submitted for analysis, with an optional room reference.",
        "properties": {
          "URL": {
            "type": "string",
            "format": "uri",
            "maxLength": 4096,
            "description": "Absolute https URL of the image. Maximum 4096 characters.",
            "example": "https://images.example-client.com/1234567/room-dbl-sea-1.jpg"
          },
          "RoomRef": {
            "type": "string",
            "maxLength": 200,
            "description": "Optional room code or name from your own system, stored with the submission and echoed back by getVisionImages. Maximum 200 characters.",
            "example": "DBL-SEA"
          }
        }
      },
      "addTagToHotels_ErrorDetail": {
        "type": "object",
        "required": [
          "Code",
          "Message"
        ],
        "description": "Error detail containing a machine-readable code and human-readable message.",
        "properties": {
          "Code": {
            "type": "string",
            "description": "Machine-readable error code for programmatic handling.",
            "example": "VALIDATION_ERROR"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable error message.",
            "example": "Request validation failed"
          },
          "Fields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/addTagToHotels_FieldError"
            },
            "description": "Field-level validation errors. Only present for VALIDATION_ERROR responses."
          }
        }
      },
      "addTagToHotels_ErrorResponse": {
        "type": "object",
        "required": [
          "Error"
        ],
        "description": "Standard v2 error response wrapper.",
        "properties": {
          "Error": {
            "$ref": "#/components/schemas/addTagToHotels_ErrorDetail"
          }
        }
      },
      "addTagToHotels_FieldError": {
        "type": "object",
        "required": [
          "Field",
          "Message"
        ],
        "description": "A single field-level validation error.",
        "properties": {
          "Field": {
            "type": "string",
            "description": "Name of the field that failed validation.",
            "example": "HotelIDs"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable validation error message for this field.",
            "example": "HotelIDs must not be empty"
          },
          "Code": {
            "type": "string",
            "enum": [
              "REQUIRED",
              "TOO_LONG",
              "TOO_SHORT",
              "OUT_OF_RANGE",
              "TOO_MANY",
              "INVALID_FORMAT",
              "NOT_ALLOWED",
              "CONFLICT",
              "INVALID_ENCODING",
              "INSECURE_SCHEME",
              "UNSAFE_CONTENT",
              "REQUIRED_WHEN_ENABLED"
            ],
            "description": "Machine-readable reason the field failed validation. Optional; clients should fall back to Message when it is absent or unrecognized.",
            "example": "TOO_LONG"
          },
          "Params": {
            "type": "object",
            "additionalProperties": true,
            "description": "Machine-readable values the message is built from, such as limits or allowed values. Keys are PascalCase; which keys are present depends on Code. Optional.",
            "example": {
              "Max": 100
            }
          }
        }
      },
      "deleteHotelImagePin_ErrorDetail": {
        "type": "object",
        "required": [
          "Code",
          "Message"
        ],
        "description": "Error detail containing a machine-readable code and human-readable message.",
        "properties": {
          "Code": {
            "type": "string",
            "description": "Machine-readable error code for programmatic handling.",
            "example": "VALIDATION_ERROR"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable error message.",
            "example": "Request validation failed"
          },
          "Fields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/deleteHotelImagePin_FieldError"
            },
            "description": "Field-level validation errors. Only present for VALIDATION_ERROR responses."
          }
        }
      },
      "deleteHotelImagePin_ErrorResponse": {
        "type": "object",
        "required": [
          "Error"
        ],
        "description": "Standard v2 error response wrapper.",
        "properties": {
          "Error": {
            "$ref": "#/components/schemas/deleteHotelImagePin_ErrorDetail"
          }
        }
      },
      "deleteHotelImagePin_FieldError": {
        "type": "object",
        "required": [
          "Field",
          "Message"
        ],
        "description": "A single field-level validation error.",
        "properties": {
          "Field": {
            "type": "string",
            "description": "Name of the field that failed validation.",
            "example": "HotelID"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable validation error message for this field.",
            "example": "HotelID must be a valid UUID"
          },
          "Code": {
            "type": "string",
            "enum": [
              "REQUIRED",
              "TOO_LONG",
              "TOO_SHORT",
              "OUT_OF_RANGE",
              "TOO_MANY",
              "INVALID_FORMAT",
              "NOT_ALLOWED",
              "CONFLICT",
              "INVALID_ENCODING",
              "INSECURE_SCHEME",
              "UNSAFE_CONTENT",
              "REQUIRED_WHEN_ENABLED"
            ],
            "description": "Machine-readable reason the field failed validation. Optional; clients should fall back to Message when it is absent or unrecognized.",
            "example": "TOO_LONG"
          },
          "Params": {
            "type": "object",
            "additionalProperties": true,
            "description": "Machine-readable values the message is built from, such as limits or allowed values. Keys are PascalCase; which keys are present depends on Code. Optional.",
            "example": {
              "Max": 100
            }
          }
        }
      },
      "deleteHotelStars_ErrorDetail": {
        "type": "object",
        "required": [
          "Code",
          "Message"
        ],
        "description": "Error detail containing a machine-readable code and human-readable message.",
        "properties": {
          "Code": {
            "type": "string",
            "description": "Machine-readable error code for programmatic handling.",
            "example": "VALIDATION_ERROR"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable error message.",
            "example": "Request validation failed"
          },
          "Fields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/deleteHotelStars_FieldError"
            },
            "description": "Field-level validation errors. Only present for VALIDATION_ERROR responses."
          }
        }
      },
      "deleteHotelStars_ErrorResponse": {
        "type": "object",
        "required": [
          "Error"
        ],
        "description": "Standard v2 error response wrapper.",
        "properties": {
          "Error": {
            "$ref": "#/components/schemas/deleteHotelStars_ErrorDetail"
          }
        }
      },
      "deleteHotelStars_FieldError": {
        "type": "object",
        "required": [
          "Field",
          "Message"
        ],
        "description": "A single field-level validation error.",
        "properties": {
          "Field": {
            "type": "string",
            "description": "Name of the field that failed validation.",
            "example": "HotelID"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable validation error message for this field.",
            "example": "HotelID must be a valid UUID"
          },
          "Code": {
            "type": "string",
            "enum": [
              "REQUIRED",
              "TOO_LONG",
              "TOO_SHORT",
              "OUT_OF_RANGE",
              "TOO_MANY",
              "INVALID_FORMAT",
              "NOT_ALLOWED",
              "CONFLICT",
              "INVALID_ENCODING",
              "INSECURE_SCHEME",
              "UNSAFE_CONTENT",
              "REQUIRED_WHEN_ENABLED"
            ],
            "description": "Machine-readable reason the field failed validation. Optional; clients should fall back to Message when it is absent or unrecognized.",
            "example": "TOO_LONG"
          },
          "Params": {
            "type": "object",
            "additionalProperties": true,
            "description": "Machine-readable values the message is built from, such as limits or allowed values. Keys are PascalCase; which keys are present depends on Code. Optional.",
            "example": {
              "Max": 100
            }
          }
        }
      },
      "deleteTag_ErrorDetail": {
        "type": "object",
        "required": [
          "Code",
          "Message"
        ],
        "description": "Error detail containing a machine-readable code and human-readable message.",
        "properties": {
          "Code": {
            "type": "string",
            "description": "Machine-readable error code for programmatic handling.",
            "example": "VALIDATION_ERROR"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable error message.",
            "example": "Request validation failed"
          },
          "Fields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/deleteTag_FieldError"
            },
            "description": "Field-level validation errors. Only present for VALIDATION_ERROR responses."
          }
        }
      },
      "deleteTag_ErrorResponse": {
        "type": "object",
        "required": [
          "Error"
        ],
        "description": "Standard v2 error response wrapper.",
        "properties": {
          "Error": {
            "$ref": "#/components/schemas/deleteTag_ErrorDetail"
          }
        }
      },
      "deleteTag_FieldError": {
        "type": "object",
        "required": [
          "Field",
          "Message"
        ],
        "description": "A single field-level validation error.",
        "properties": {
          "Field": {
            "type": "string",
            "description": "Name of the field that failed validation.",
            "example": "TagID"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable validation error message for this field.",
            "example": "TagID must be a valid UUID"
          },
          "Code": {
            "type": "string",
            "enum": [
              "REQUIRED",
              "TOO_LONG",
              "TOO_SHORT",
              "OUT_OF_RANGE",
              "TOO_MANY",
              "INVALID_FORMAT",
              "NOT_ALLOWED",
              "CONFLICT",
              "INVALID_ENCODING",
              "INSECURE_SCHEME",
              "UNSAFE_CONTENT",
              "REQUIRED_WHEN_ENABLED"
            ],
            "description": "Machine-readable reason the field failed validation. Optional; clients should fall back to Message when it is absent or unrecognized.",
            "example": "TOO_LONG"
          },
          "Params": {
            "type": "object",
            "additionalProperties": true,
            "description": "Machine-readable values the message is built from, such as limits or allowed values. Keys are PascalCase; which keys are present depends on Code. Optional.",
            "example": {
              "Max": 100
            }
          }
        }
      },
      "deleteVisionImages_ErrorDetail": {
        "type": "object",
        "required": [
          "Code",
          "Message"
        ],
        "description": "Error detail containing a machine-readable code and human-readable message.",
        "properties": {
          "Code": {
            "type": "string",
            "description": "Machine-readable error code for programmatic handling.",
            "example": "VALIDATION_ERROR"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable error message.",
            "example": "Validation failed"
          },
          "Fields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/deleteVisionImages_FieldError"
            },
            "description": "Field-level validation errors. Only present for VALIDATION_ERROR responses."
          }
        }
      },
      "deleteVisionImages_ErrorResponse": {
        "type": "object",
        "required": [
          "Error"
        ],
        "description": "Standard v2 error response wrapper.",
        "properties": {
          "Error": {
            "$ref": "#/components/schemas/deleteVisionImages_ErrorDetail"
          }
        }
      },
      "deleteVisionImages_FieldError": {
        "type": "object",
        "required": [
          "Field",
          "Message"
        ],
        "description": "A single field-level validation error.",
        "properties": {
          "Field": {
            "type": "string",
            "description": "Name of the field that failed validation. Per-entry errors carry the entry's position, for example ImageIDs[2].",
            "example": "ImageIDs[2]"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable validation error message for this field.",
            "example": "ImageID must be a valid UUID"
          },
          "Code": {
            "type": "string",
            "enum": [
              "REQUIRED",
              "TOO_LONG",
              "TOO_SHORT",
              "OUT_OF_RANGE",
              "TOO_MANY",
              "INVALID_FORMAT",
              "NOT_ALLOWED",
              "CONFLICT",
              "INVALID_ENCODING",
              "INSECURE_SCHEME",
              "UNSAFE_CONTENT",
              "REQUIRED_WHEN_ENABLED"
            ],
            "description": "Machine-readable reason the field failed validation. Optional; clients should fall back to Message when it is absent or unrecognized.",
            "example": "TOO_LONG"
          },
          "Params": {
            "type": "object",
            "additionalProperties": true,
            "description": "Machine-readable values the message is built from, such as limits or allowed values; keys are PascalCase and depend on Code. Optional.",
            "example": {
              "Max": 100
            }
          }
        }
      },
      "generateText_ErrorDetail": {
        "type": "object",
        "required": [
          "Code",
          "Message"
        ],
        "description": "Error detail containing a machine-readable code and human-readable message.",
        "properties": {
          "Code": {
            "type": "string",
            "description": "Machine-readable error code for programmatic handling.",
            "example": "VALIDATION_ERROR"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable error message.",
            "example": "Request validation failed"
          },
          "Fields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/generateText_FieldError"
            },
            "description": "Field-level validation errors. Only present for VALIDATION_ERROR responses."
          }
        }
      },
      "generateText_ErrorResponse": {
        "type": "object",
        "required": [
          "Error"
        ],
        "description": "Standard v2 error response wrapper.",
        "properties": {
          "Error": {
            "$ref": "#/components/schemas/generateText_ErrorDetail"
          }
        }
      },
      "generateText_FieldError": {
        "type": "object",
        "required": [
          "Field",
          "Message"
        ],
        "description": "A single field-level validation error.",
        "properties": {
          "Field": {
            "type": "string",
            "description": "Name of the field that failed validation.",
            "example": "HotelIDs"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable validation error message for this field.",
            "example": "HotelIDs or TagIDs is required"
          },
          "Code": {
            "type": "string",
            "enum": [
              "REQUIRED",
              "TOO_LONG",
              "TOO_SHORT",
              "OUT_OF_RANGE",
              "TOO_MANY",
              "INVALID_FORMAT",
              "NOT_ALLOWED",
              "CONFLICT",
              "INVALID_ENCODING",
              "INSECURE_SCHEME",
              "UNSAFE_CONTENT",
              "REQUIRED_WHEN_ENABLED"
            ],
            "description": "Machine-readable reason the field failed validation. Optional; clients should fall back to Message when it is absent or unrecognized.",
            "example": "TOO_LONG"
          },
          "Params": {
            "type": "object",
            "additionalProperties": true,
            "description": "Machine-readable values the message is built from, such as limits or allowed values. Keys are PascalCase; which keys are present depends on Code. Optional.",
            "example": {
              "Max": 100
            }
          }
        }
      },
      "getContentSettings_ErrorDetail": {
        "type": "object",
        "required": [
          "Code",
          "Message"
        ],
        "description": "Error detail containing a machine-readable code and human-readable message.",
        "properties": {
          "Code": {
            "type": "string",
            "description": "Machine-readable error code for programmatic handling.",
            "example": "VALIDATION_ERROR"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable error message.",
            "example": "Request validation failed"
          },
          "Fields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/getContentSettings_FieldError"
            },
            "description": "Field-level validation errors. Only present for VALIDATION_ERROR responses."
          }
        }
      },
      "getContentSettings_ErrorResponse": {
        "type": "object",
        "required": [
          "Error"
        ],
        "description": "Standard v2 error response wrapper.",
        "properties": {
          "Error": {
            "$ref": "#/components/schemas/getContentSettings_ErrorDetail"
          }
        }
      },
      "getContentSettings_FieldError": {
        "type": "object",
        "required": [
          "Field",
          "Message"
        ],
        "description": "A single field-level validation error.",
        "properties": {
          "Field": {
            "type": "string",
            "description": "Name of the field that failed validation.",
            "example": "X-Project-ID"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable validation error message for this field.",
            "example": "X-Project-ID is required"
          },
          "Code": {
            "type": "string",
            "enum": [
              "REQUIRED",
              "TOO_LONG",
              "TOO_SHORT",
              "OUT_OF_RANGE",
              "TOO_MANY",
              "INVALID_FORMAT",
              "NOT_ALLOWED",
              "CONFLICT",
              "INVALID_ENCODING",
              "INSECURE_SCHEME",
              "UNSAFE_CONTENT",
              "REQUIRED_WHEN_ENABLED"
            ],
            "description": "Machine-readable reason the field failed validation. Optional; clients should fall back to Message when it is absent or unrecognized.",
            "example": "TOO_LONG"
          },
          "Params": {
            "type": "object",
            "additionalProperties": true,
            "description": "Machine-readable values the message is built from, such as limits or allowed values. Keys are PascalCase; which keys are present depends on Code. Optional.",
            "example": {
              "Max": 100
            }
          }
        }
      },
      "getEnrichedHotel_ErrorDetail": {
        "type": "object",
        "required": [
          "Code",
          "Message"
        ],
        "description": "Error detail containing a machine-readable code and human-readable message.",
        "properties": {
          "Code": {
            "type": "string",
            "description": "Machine-readable error code for programmatic handling.",
            "example": "VALIDATION_ERROR"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable error message.",
            "example": "Request validation failed"
          },
          "Fields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/getEnrichedHotel_FieldError"
            },
            "description": "Field-level validation errors. Only present for VALIDATION_ERROR responses."
          }
        }
      },
      "getEnrichedHotel_ErrorResponse": {
        "type": "object",
        "required": [
          "Error"
        ],
        "description": "Standard v2 error response wrapper.",
        "properties": {
          "Error": {
            "$ref": "#/components/schemas/getEnrichedHotel_ErrorDetail"
          }
        }
      },
      "getEnrichedHotel_FieldError": {
        "type": "object",
        "required": [
          "Field",
          "Message"
        ],
        "description": "A single field-level validation error.",
        "properties": {
          "Field": {
            "type": "string",
            "description": "Name of the field that failed validation.",
            "example": "HotelID"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable validation error message for this field.",
            "example": "Provide exactly one of HotelID, GlobalHotelID, or ExternalHotelID"
          },
          "Code": {
            "type": "string",
            "enum": [
              "REQUIRED",
              "TOO_LONG",
              "TOO_SHORT",
              "OUT_OF_RANGE",
              "TOO_MANY",
              "INVALID_FORMAT",
              "NOT_ALLOWED",
              "CONFLICT",
              "INVALID_ENCODING",
              "INSECURE_SCHEME",
              "UNSAFE_CONTENT",
              "REQUIRED_WHEN_ENABLED"
            ],
            "description": "Machine-readable reason the field failed validation. Optional; clients should fall back to Message when it is absent or unrecognized.",
            "example": "REQUIRED"
          },
          "Params": {
            "type": "object",
            "additionalProperties": true,
            "description": "Machine-readable values the message is built from, such as limits or allowed values; keys are PascalCase and depend on Code. Optional.",
            "example": {
              "Max": 100
            }
          }
        }
      },
      "getTextGenerationStatus_ErrorDetail": {
        "type": "object",
        "required": [
          "Code",
          "Message"
        ],
        "description": "Error detail containing a machine-readable code and human-readable message.",
        "properties": {
          "Code": {
            "type": "string",
            "description": "Machine-readable error code for programmatic handling.",
            "example": "VALIDATION_ERROR"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable error message.",
            "example": "Request validation failed"
          },
          "Fields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/getTextGenerationStatus_FieldError"
            },
            "description": "Field-level validation errors. Only present for VALIDATION_ERROR responses."
          }
        }
      },
      "getTextGenerationStatus_ErrorResponse": {
        "type": "object",
        "required": [
          "Error"
        ],
        "description": "Standard v2 error response wrapper.",
        "properties": {
          "Error": {
            "$ref": "#/components/schemas/getTextGenerationStatus_ErrorDetail"
          }
        }
      },
      "getTextGenerationStatus_FieldError": {
        "type": "object",
        "required": [
          "Field",
          "Message"
        ],
        "description": "A single field-level validation error.",
        "properties": {
          "Field": {
            "type": "string",
            "description": "Name of the field that failed validation.",
            "example": "RunID"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable validation error message for this field.",
            "example": "RunID is required"
          },
          "Code": {
            "type": "string",
            "enum": [
              "REQUIRED",
              "TOO_LONG",
              "TOO_SHORT",
              "OUT_OF_RANGE",
              "TOO_MANY",
              "INVALID_FORMAT",
              "NOT_ALLOWED",
              "CONFLICT",
              "INVALID_ENCODING",
              "INSECURE_SCHEME",
              "UNSAFE_CONTENT",
              "REQUIRED_WHEN_ENABLED"
            ],
            "description": "Machine-readable reason the field failed validation. Optional; clients should fall back to Message when it is absent or unrecognized.",
            "example": "TOO_LONG"
          },
          "Params": {
            "type": "object",
            "additionalProperties": true,
            "description": "Machine-readable values the message is built from, such as limits or allowed values. Keys are PascalCase; which keys are present depends on Code. Optional.",
            "example": {
              "Max": 100
            }
          }
        }
      },
      "getTextGenerationStatus_RunProgress": {
        "type": "object",
        "required": [
          "Total",
          "Generated",
          "Failed",
          "Skipped"
        ],
        "description": "Per-hotel progress counters for the run.",
        "properties": {
          "Total": {
            "type": "integer",
            "description": "Total number of hotels in the run.",
            "example": 5
          },
          "Generated": {
            "type": "integer",
            "description": "Number of hotels for which text has been generated so far.",
            "example": 2
          },
          "Failed": {
            "type": "integer",
            "description": "Number of hotels that failed processing.",
            "example": 0
          },
          "Skipped": {
            "type": "integer",
            "description": "Number of hotels skipped because they needed no work.",
            "example": 0
          }
        }
      },
      "getVisionImages_Compliance": {
        "type": "object",
        "properties": {
          "AIGenerated": {
            "type": "boolean",
            "description": "EU AI Act Art. 50(2) machine-readable marker: `true` when the text content of the enclosing object is AI-generated. Always stated explicitly when the envelope is present.",
            "example": true
          }
        }
      },
      "getVisionImages_ErrorDetail": {
        "type": "object",
        "required": [
          "Code",
          "Message"
        ],
        "description": "Error detail containing a machine-readable code and human-readable message.",
        "properties": {
          "Code": {
            "type": "string",
            "description": "Machine-readable error code for programmatic handling.",
            "example": "VALIDATION_ERROR"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable error message.",
            "example": "Validation failed"
          },
          "Fields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/getVisionImages_FieldError"
            },
            "description": "Field-level validation errors. Only present for VALIDATION_ERROR responses."
          }
        }
      },
      "getVisionImages_ErrorResponse": {
        "type": "object",
        "required": [
          "Error"
        ],
        "description": "Standard v2 error response wrapper.",
        "properties": {
          "Error": {
            "$ref": "#/components/schemas/getVisionImages_ErrorDetail"
          }
        }
      },
      "getVisionImages_FieldError": {
        "type": "object",
        "required": [
          "Field",
          "Message"
        ],
        "description": "A single field-level validation error.",
        "properties": {
          "Field": {
            "type": "string",
            "description": "Name of the field that failed validation. Per-entry errors carry the entry's position, for example ImageIDs[2].",
            "example": "ImageIDs[2]"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable validation error message for this field.",
            "example": "ImageID must be a valid UUID"
          },
          "Code": {
            "type": "string",
            "enum": [
              "REQUIRED",
              "TOO_LONG",
              "TOO_SHORT",
              "OUT_OF_RANGE",
              "TOO_MANY",
              "INVALID_FORMAT",
              "NOT_ALLOWED",
              "CONFLICT",
              "INVALID_ENCODING",
              "INSECURE_SCHEME",
              "UNSAFE_CONTENT",
              "REQUIRED_WHEN_ENABLED"
            ],
            "description": "Machine-readable reason the field failed validation. Optional; clients should fall back to Message when it is absent or unrecognized.",
            "example": "TOO_LONG"
          },
          "Params": {
            "type": "object",
            "additionalProperties": true,
            "description": "Machine-readable values the message is built from, such as limits or allowed values; keys are PascalCase and depend on Code. Optional.",
            "example": {
              "Max": 100
            }
          }
        }
      },
      "getVisionImages_Image": {
        "type": "object",
        "required": [
          "ID",
          "URL"
        ],
        "properties": {
          "ID": {
            "type": "string",
            "format": "uuid",
            "description": "Unique image UUID.",
            "example": "0192fb21-2bb3-7def-9abc-2233445566bb"
          },
          "URL": {
            "type": "string",
            "format": "uri",
            "description": "Image URL.",
            "example": "https://images.example-client.com/1234567/room-dbl-sea-1.jpg"
          },
          "Source": {
            "type": "string",
            "description": "Detected provenance of the pixels: `photo`, `render`, `illustration` or `ai_generated`. Omitted when the image carries no provenance assessment.",
            "example": "photo"
          },
          "Category": {
            "type": "string",
            "description": "Vision-derived image category (e.g. exterior, room, pool, restaurant).",
            "example": "room"
          },
          "Features": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Vision-derived feature tags depicted in the image.",
            "example": [
              "sea_view",
              "balcony"
            ]
          },
          "Mood": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Vision-derived mood descriptors.",
            "example": [
              "bright",
              "calm"
            ]
          },
          "Tags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Additional vision-derived tags.",
            "example": [
              "sea_view"
            ]
          },
          "Flags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Quality / content flags raised by vision analysis. Omitted when empty."
          },
          "AppealScore": {
            "type": "integer",
            "description": "Appeal score from 0 to 100, or -1 when there is no scorer-stamped value and no value above 0, normally because nothing has scored the image yet. -1 is not a score and does not affect image order.",
            "example": 82
          },
          "QualityScore": {
            "type": "integer",
            "description": "Technical quality score from 0 to 100, or -1 when there is no scorer-stamped value and no value above 0, normally because nothing has scored the image yet. -1 is not a score and does not affect image order.",
            "example": 77
          },
          "AppealScoreVersion": {
            "type": "string",
            "description": "Version stamp of the scorer that produced AppealScore, for example `app-v4`; it may name an earlier version. Absent when AppealScore is -1 or a legacy score from before stamps existed.",
            "example": "app-v4"
          },
          "QualityScoreVersion": {
            "type": "string",
            "description": "Version stamp of the scorer that produced QualityScore, for example `qs-v4`; it may name an earlier version. Absent when QualityScore is -1, a legacy score, or a first-seen image's provisional score.",
            "example": "qs-v4"
          },
          "Width": {
            "type": "integer",
            "description": "Image width in pixels.",
            "example": 1600
          },
          "Height": {
            "type": "integer",
            "description": "Image height in pixels.",
            "example": 1067
          },
          "Format": {
            "type": "string",
            "description": "Image format (e.g. jpeg, png, webp).",
            "example": "jpeg"
          },
          "FileSize": {
            "type": "integer",
            "description": "File size in bytes.",
            "example": 412000
          },
          "DominantColor": {
            "type": "string",
            "description": "Dominant color as a hex string.",
            "example": "#2E6F95"
          },
          "BlurHash": {
            "type": "string",
            "description": "BlurHash placeholder string for progressive loading.",
            "example": "LEHV6nWB2yk8pyo0adR*"
          },
          "FileMetadata": {
            "type": "object",
            "description": "What the image file itself states in its embedded IPTC/EXIF/XMP metadata: capture date and copyright notice. Omitted when the file states neither; inside it, a value the file did not state has no key.",
            "properties": {
              "CaptureDate": {
                "type": "string",
                "pattern": "^\\d{4}(-\\d{2}(-\\d{2})?)?$",
                "description": "Date the photograph was taken, at the precision the file stated: `2012-06-14`, `2012-06` or `2012`. It carries no time of day and no timezone.",
                "example": "2012-06-14"
              },
              "Copyright": {
                "type": "string",
                "description": "The copyright notice the file carries, as the file wrote it. It names who to ask; it is not a machine-readable licence.",
                "example": "© 2012 Hotel Sol S.A."
              }
            },
            "example": {
              "CaptureDate": "2012-06-14",
              "Copyright": "© 2012 Hotel Sol S.A."
            }
          },
          "Descriptions": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Neutral alt text describing what the image shows, not marketing copy, keyed by BCP 47 language tag. More locales may be added after an image is first analyzed.",
            "example": {
              "en-US": "Double room with a balcony overlooking the sea.",
              "de-DE": "Doppelzimmer mit Balkon und Meerblick."
            }
          },
          "Compliance": {
            "allOf": [
              {
                "$ref": "#/components/schemas/getVisionImages_Compliance"
              }
            ],
            "description": "EU AI Act Article 50(2) marker for this image. Always present with `AIGenerated` true: the category, features, mood, tags, scores and descriptions are model output, `FileMetadata` is not."
          },
          "Presence": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PresenceDetection"
            },
            "description": "People and animals seen in the image, from the closed vocabulary person, adult, child, animal. Omitted when the image carries no presence measurement."
          },
          "Safety": {
            "type": "object",
            "additionalProperties": {
              "type": "number",
              "format": "float",
              "nullable": true,
              "minimum": 0,
              "maximum": 1
            },
            "description": "Safety confidences keyed by dimension, `Inappropriate` and `OffTopic`, each between 0 and 1 or null. Omitted when the image carries no safety measurement.",
            "example": {
              "Inappropriate": 0.02,
              "OffTopic": null
            }
          },
          "TextDetections": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TextDetection"
            },
            "description": "Texts read off the image, each with its kind. Omitted when the image carries no text measurement."
          },
          "FeatureDetections": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FeatureDetection"
            },
            "description": "The image's features with the confidence measured for each, running parallel to `Features`. Omitted when the image carries no feature measurement."
          },
          "Nudity": {
            "type": "object",
            "description": "Nudity assessment: exposure score, reason and explicit flag, independent of `Safety.Inappropriate`. Omitted when the assessment did not run or the image's `Presence` shows no person.",
            "required": [
              "Score",
              "Reason",
              "Explicit"
            ],
            "properties": {
              "Score": {
                "type": "integer",
                "minimum": 0,
                "maximum": 100,
                "description": "Exposure score from 0 to 100. Anchors: 20 beach or casual wear, 40 standard swimwear, 60 revealing swimwear or lingerie, 80 partial nudity, 100 explicit.",
                "example": 60
              },
              "Reason": {
                "type": "string",
                "description": "One model-written sentence naming what drives the score, at most 240 characters. Not sanitized for markup, so escape it before rendering.",
                "example": "Adult in revealing swimwear by the pool."
              },
              "Explicit": {
                "type": "boolean",
                "description": "True from a score of 90 up. Whether a child is in the picture is answered by `Presence`, not here.",
                "example": false
              }
            }
          }
        }
      },
      "ingestVisionImages_ErrorDetail": {
        "type": "object",
        "required": [
          "Code",
          "Message"
        ],
        "description": "Error detail containing a machine-readable code and human-readable message.",
        "properties": {
          "Code": {
            "type": "string",
            "description": "Machine-readable error code for programmatic handling.",
            "example": "VALIDATION_ERROR"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable error message.",
            "example": "Validation failed"
          },
          "Fields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ingestVisionImages_FieldError"
            },
            "description": "Field-level validation errors. Only present for VALIDATION_ERROR responses."
          }
        }
      },
      "ingestVisionImages_ErrorResponse": {
        "type": "object",
        "required": [
          "Error"
        ],
        "description": "Standard v2 error response wrapper.",
        "properties": {
          "Error": {
            "$ref": "#/components/schemas/ingestVisionImages_ErrorDetail"
          }
        }
      },
      "ingestVisionImages_FieldError": {
        "type": "object",
        "required": [
          "Field",
          "Message"
        ],
        "description": "A single field-level validation error.",
        "properties": {
          "Field": {
            "type": "string",
            "description": "Name of the field that failed validation. Per-image errors carry the image's position, for example Images[3].URL.",
            "example": "Images[3].URL"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable validation error message for this field.",
            "example": "URL must be an absolute https URL"
          },
          "Code": {
            "type": "string",
            "enum": [
              "REQUIRED",
              "TOO_LONG",
              "TOO_SHORT",
              "OUT_OF_RANGE",
              "TOO_MANY",
              "INVALID_FORMAT",
              "NOT_ALLOWED",
              "CONFLICT",
              "INVALID_ENCODING",
              "INSECURE_SCHEME",
              "UNSAFE_CONTENT",
              "REQUIRED_WHEN_ENABLED"
            ],
            "description": "Machine-readable reason the field failed validation. Optional; clients should fall back to Message when it is absent or unrecognized.",
            "example": "TOO_LONG"
          },
          "Params": {
            "type": "object",
            "additionalProperties": true,
            "description": "Machine-readable values the message is built from, such as limits or allowed values; keys are PascalCase and depend on Code. Optional.",
            "example": {
              "Max": 100
            }
          }
        }
      },
      "listApprovals_ApprovalLink": {
        "type": "object",
        "required": [
          "HotelID",
          "HotelName",
          "TokenPreview",
          "Status",
          "Created",
          "CreatedAt",
          "UpdatedAt"
        ],
        "description": "One hotel's approval link and its state. The same shape is returned by createApprovalLinks and rotateApprovalLink (and by revokeApprovalLink, without `Token`: the link is dead). Note: this listing deliberately does not carry the full `Token` (contract A10.1) — a roster load returns up to 500 rows, and the plaintext token is a live mailable credential. Use `TokenPreview` for display; createApprovalLinks and rotateApprovalLink return the full token for the single hotel they act on.",
        "properties": {
          "HotelID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the hotel this link belongs to.",
            "example": "019d9c2e-0ef8-7458-b0fa-8bed7182eb30"
          },
          "HotelName": {
            "type": "string",
            "description": "Display name of the hotel.",
            "example": "Sotavento Beach Club"
          },
          "GiataID": {
            "type": "integer",
            "description": "The hotel's GIATA id. Omitted when the hotel has none.",
            "example": 5721
          },
          "MasterCode": {
            "type": "string",
            "description": "The calling project's master code for this hotel. Omitted when the project has no code for it.",
            "example": "FUED0009"
          },
          "TokenPreview": {
            "type": "string",
            "description": "Display form of the token: its first 8 characters followed by an ellipsis. Never enough to reconstruct the link.",
            "example": "xPBOjXHo..."
          },
          "Status": {
            "type": "string",
            "enum": [
              "waiting_for_hotel",
              "feedback_received",
              "feedback_applied",
              "approved"
            ],
            "description": "Approval state of this hotel's link. `waiting_for_hotel` on creation; any feedback moves it to `feedback_received`; `feedback_applied` is set once the feedback has been worked in; `approved` is never left by a later feedback submission; the one way back to `waiting_for_hotel` is a re-minted link (createApprovalLinks after a revoke), which keeps ApprovedAt, ApprovedTextGeneratedAt and ApprovedBy as the record of the earlier approval.",
            "example": "waiting_for_hotel"
          },
          "ApprovedAt": {
            "type": "string",
            "format": "date-time",
            "description": "When the hotel approved (RFC3339). Present once the hotel has ever approved: it is the RECORD of that approval and survives a later revoke and a re-minted link, so it can accompany a `waiting_for_hotel` Status (see createApprovalLinks). Only a fresh approval replaces it.",
            "example": "2026-08-25T18:19:18.860882Z"
          },
          "ApprovedTextGeneratedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Newest generation timestamp across the texts that were approved (RFC3339). Compare it with the hotel's current texts to see whether they changed since the approval. Present once the hotel has ever approved (it survives a revoke and a re-minted link, like ApprovedAt), and omitted then if none of the approved texts carried a timestamp.",
            "example": "2026-08-19T14:14:57.674681Z"
          },
          "ApprovedBy": {
            "allOf": [
              {
                "$ref": "#/components/schemas/ApprovalApprover"
              }
            ],
            "description": "Present once the hotel has ever approved: the record of who signed off, kept across a later revoke and a re-minted link (so it can accompany a `waiting_for_hotel` Status) and replaced only by a fresh approval. The identity is the snapshot taken at approval time and survives deletion of the contact record (`approved_by` is `ON DELETE SET NULL`; the snapshot columns are not cleared)."
          },
          "LastOpenedAt": {
            "type": "string",
            "format": "date-time",
            "description": "When the approval page was last loaded (RFC3339). Omitted while the link has never been opened.",
            "example": "2026-08-25T18:19:18.966928Z"
          },
          "RevokedAt": {
            "type": "string",
            "format": "date-time",
            "description": "When the link was revoked (RFC3339). Omitted while the link is live. A link carrying it is never returned with a `Token`.",
            "example": "2026-08-25T18:19:19.602402Z"
          },
          "Created": {
            "type": "boolean",
            "description": "`true` only when this call minted the credential in `Token`: a brand-new link, or a fresh one for a hotel whose link had been revoked. `false` for a hotel that already had a live link, and always `false` on rotateApprovalLink, revokeApprovalLink and listApprovals.",
            "example": true
          },
          "CreatedBy": {
            "type": "string",
            "description": "Audit identity of who minted the link: a user token records the user's email; a project API key records its project-scoped identity (`project:<project-uuid>`). That is what is STORED; what is RETURNED is gated. The stored identity is an operator identity by construction, so in practice it carries an internal staff email — a contact route, and therefore contact PII on the same footing as `ApprovedBy.Email` and `ApprovedBy.Phone`: it is returned only to a caller presenting a user_ token, and is omitted entirely for a proj_ project token (the key is absent, not an empty string).",
            "example": "editor@example.com"
          },
          "CreatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "When the link was minted (RFC3339).",
            "example": "2026-08-25T18:19:17.522006Z"
          },
          "UpdatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "When the link row was last touched (RFC3339). The `updated_at` trigger fires on every update, so this moves on a status transition, an approval and a token rotation — and also when the hotel merely opens the page, because that stamps `last_opened_at`. Do not use it to detect approval-state changes.",
            "example": "2026-08-25T18:19:17.522006Z"
          }
        }
      },
      "listEnrichedHotelSummaries_ErrorDetail": {
        "type": "object",
        "required": [
          "Code",
          "Message"
        ],
        "description": "Error detail containing a machine-readable code and human-readable message.",
        "properties": {
          "Code": {
            "type": "string",
            "description": "Machine-readable error code for programmatic handling.",
            "example": "VALIDATION_ERROR"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable error message.",
            "example": "Request validation failed"
          },
          "Fields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/listEnrichedHotelSummaries_FieldError"
            },
            "description": "Field-level validation errors. Only present for VALIDATION_ERROR responses."
          }
        }
      },
      "listEnrichedHotelSummaries_ErrorResponse": {
        "type": "object",
        "required": [
          "Error"
        ],
        "description": "Standard v2 error response wrapper.",
        "properties": {
          "Error": {
            "$ref": "#/components/schemas/listEnrichedHotelSummaries_ErrorDetail"
          }
        }
      },
      "listEnrichedHotelSummaries_FieldError": {
        "type": "object",
        "required": [
          "Field",
          "Message"
        ],
        "description": "A single field-level validation error.",
        "properties": {
          "Field": {
            "type": "string",
            "description": "Name of the field that failed validation.",
            "example": "TextEnrichmentStatus"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable validation error message for this field.",
            "example": "TextEnrichmentStatus must be 'enriched', 'enriching', or 'none'"
          },
          "Code": {
            "type": "string",
            "enum": [
              "REQUIRED",
              "TOO_LONG",
              "TOO_SHORT",
              "OUT_OF_RANGE",
              "TOO_MANY",
              "INVALID_FORMAT",
              "NOT_ALLOWED",
              "CONFLICT",
              "INVALID_ENCODING",
              "INSECURE_SCHEME",
              "UNSAFE_CONTENT",
              "REQUIRED_WHEN_ENABLED"
            ],
            "description": "Machine-readable reason the field failed validation. Optional; clients should fall back to Message when it is absent or unrecognized.",
            "example": "TOO_LONG"
          },
          "Params": {
            "type": "object",
            "additionalProperties": true,
            "description": "Machine-readable values the message is built from, such as limits or allowed values; keys are PascalCase and depend on Code. Optional.",
            "example": {
              "Max": 100
            }
          }
        }
      },
      "listEnrichedHotelSummaries_Pagination": {
        "type": "object",
        "required": [
          "Total",
          "Limit",
          "Offset"
        ],
        "description": "Pagination metadata for a list response.",
        "properties": {
          "Total": {
            "type": "integer",
            "description": "Total number of items matching the request across all pages.",
            "example": 128
          },
          "Limit": {
            "type": "integer",
            "description": "Maximum number of items returned in this page.",
            "example": 50
          },
          "Offset": {
            "type": "integer",
            "description": "Number of items skipped before this page.",
            "example": 0
          }
        }
      },
      "listEnrichedHotelSummaries_ProjectTagSummary": {
        "type": "object",
        "required": [
          "ID",
          "Name"
        ],
        "description": "A reference to one of this project's internal tags applied to the hotel: the tag id, display name and optional description.",
        "properties": {
          "ID": {
            "type": "string",
            "format": "uuid",
            "description": "Unique project tag UUID.",
            "example": "0192fc01-1111-7abc-8def-aaaaaaaaaaaa"
          },
          "Name": {
            "type": "string",
            "description": "Tag display name.",
            "example": "Summer Campaign"
          },
          "Description": {
            "type": "string",
            "description": "Tag description. Omitted when the tag has none.",
            "example": "Hotels in the 2026 summer campaign"
          }
        }
      },
      "listEnrichedHotelSummaries_StarsMap": {
        "type": "object",
        "description": "Grades by source, in default's order: project (yours, if set), national, association, canonical (the hotel's own site); new keys may appear. default is always present: the first of these, else the collected rating or 0.",
        "additionalProperties": {
          "$ref": "#/components/schemas/StarsMapEntry"
        }
      },
      "listEnrichedHotels_EnrichedHotel": {
        "type": "object",
        "required": [
          "ID",
          "Name",
          "Names",
          "Stars",
          "StarsMap",
          "AccommodationType",
          "Location",
          "FactualAttributes",
          "POIs",
          "GeneratedTexts",
          "Images",
          "Rooms",
          "Status",
          "CreatedAt",
          "UpdatedAt"
        ],
        "description": "A fully enriched hotel with its identity, location, factual attributes, structured check-in / check-out times, per-locale generated texts, guest rating, images, rooms, and the project's internal tags applied to it.",
        "properties": {
          "ID": {
            "type": "string",
            "format": "uuid",
            "description": "Unique hotel UUID.",
            "example": "0192fb17-5dc6-7abc-8def-123456789abc"
          },
          "Name": {
            "type": "string",
            "description": "Normalized English (en-US) hotel display name.",
            "example": "Bahia Azul Beach Resort"
          },
          "Names": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Per-locale display names keyed by BCP 47 language tag, always including en-US. Other locales appear only when a localized name has been generated.",
            "example": {
              "en-US": "Bahia Azul Beach Resort",
              "de-DE": "Bahia Azul Strandresort"
            }
          },
          "ExternalHotelIDs": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "External identifiers this hotel is known by, omitted when it has none. Current keys are `ProductID`, `Giata` and `PeakworkGoalID`, each only when it applies; the map is open, so read the keys you need.",
            "example": {
              "ProductID": "HTL-MAJ-4711",
              "Giata": "668370",
              "PeakworkGoalID": "864521"
            }
          },
          "GlobalHotelID": {
            "type": "string",
            "description": "Cross-tenant global hotel identifier. Omitted when the hotel has no global ID assigned.",
            "example": "ES-MALLR-K7MP2"
          },
          "Stars": {
            "type": "number",
            "format": "float",
            "description": "The hotel's default star grade (StarsMap.default.Stars); 0 when unrated.",
            "example": 4
          },
          "StarsMap": {
            "$ref": "#/components/schemas/listEnrichedHotels_StarsMap"
          },
          "AccommodationType": {
            "type": "string",
            "description": "Accommodation kind, for example hotel, apartment, aparthotel, resort, villa, hostel, guesthouse, bed_and_breakfast, cruise_ship or holiday_village. The set of values may be extended, so read it as an open string.",
            "example": "hotel"
          },
          "Chain": {
            "type": "string",
            "description": "Hotel company the property belongs to. Omitted when the hotel has no chain recorded.",
            "example": "Accor"
          },
          "Brand": {
            "type": "string",
            "description": "Product line within the chain the property is marketed under. Omitted when the hotel has no brand recorded.",
            "example": "Novotel"
          },
          "Location": {
            "$ref": "#/components/schemas/Location"
          },
          "FactualAttributes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FactualAttribute"
            },
            "description": "Hotel-level factual attributes (amenities, facilities, grouped on-site facility families, and group header rows)."
          },
          "POIs": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/POI"
            },
            "description": "Nearby points of interest with localized names and, where there is one to show, distances."
          },
          "CheckIn": {
            "$ref": "#/components/schemas/CheckIn"
          },
          "CheckOut": {
            "$ref": "#/components/schemas/CheckOut"
          },
          "GeneratedTexts": {
            "$ref": "#/components/schemas/GeneratedTexts"
          },
          "GuestRating": {
            "$ref": "#/components/schemas/GuestRating"
          },
          "RenderLayouts": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Optional rendering hints, not enrichment data: template key to layout hint such as `prose`, `highlights`, `roomcards` or `summary`. Only keys whose template carries a hint are included.",
            "example": {
              "Summary": "prose",
              "HouseRules": "highlights"
            }
          },
          "Images": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Image"
            },
            "description": "Hotel-level images, deduplicated and sorted by category priority. An image pinned in your project (see PinnedImageID) is served first, ahead of that order."
          },
          "PinnedImageID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the pinned image promoted to the front of `Images`, always the first entry's ID. Omitted when no pin is in effect.",
            "example": "0192fb20-1aa2-7def-9abc-1122334455aa"
          },
          "Rooms": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EnrichedRoom"
            },
            "description": "Enriched room types belonging to this hotel."
          },
          "Tags": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/listEnrichedHotels_ProjectTagSummary"
            },
            "description": "This project's internal tags applied to the hotel (never another project's tags). Present only when the hotel carries one or more; omitted otherwise."
          },
          "Status": {
            "type": "string",
            "enum": [
              "draft",
              "active",
              "inactive",
              "closed_temporarily",
              "closed_permanently",
              "removed"
            ],
            "description": "The hotel's status in your project, first match wins: `closed_permanently`, `closed_temporarily`, `removed` (out of the catalog), `inactive`, `active` (active in the catalog, with texts), else `draft`.",
            "example": "active"
          },
          "TextStatus": {
            "type": "string",
            "enum": [
              "none",
              "generating",
              "generated",
              "failed"
            ],
            "description": "Your project's text state of the hotel, first match wins: `generating`, `failed` (latest generation failed; older texts stay), `generated` (texts held), else `none`.",
            "example": "generated"
          },
          "CreatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the hotel record was created (RFC3339).",
            "example": "2026-03-01T08:00:00Z"
          },
          "UpdatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the hotel record was last updated (RFC3339).",
            "example": "2026-04-12T09:15:00Z"
          }
        }
      },
      "listEnrichedHotels_ErrorDetail": {
        "type": "object",
        "required": [
          "Code",
          "Message"
        ],
        "description": "Error detail containing a machine-readable code and human-readable message.",
        "properties": {
          "Code": {
            "type": "string",
            "description": "Machine-readable error code for programmatic handling.",
            "example": "VALIDATION_ERROR"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable error message.",
            "example": "Request validation failed"
          },
          "Fields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/listEnrichedHotels_FieldError"
            },
            "description": "Field-level validation errors. Only present for VALIDATION_ERROR responses."
          }
        }
      },
      "listEnrichedHotels_ErrorResponse": {
        "type": "object",
        "required": [
          "Error"
        ],
        "description": "Standard v2 error response wrapper.",
        "properties": {
          "Error": {
            "$ref": "#/components/schemas/listEnrichedHotels_ErrorDetail"
          }
        }
      },
      "listEnrichedHotels_FieldError": {
        "type": "object",
        "required": [
          "Field",
          "Message"
        ],
        "description": "A single field-level validation error.",
        "properties": {
          "Field": {
            "type": "string",
            "description": "Name of the field that failed validation.",
            "example": "TextEnrichmentStatus"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable validation error message for this field.",
            "example": "TextEnrichmentStatus must be 'enriched', 'enriching', or 'none'"
          },
          "Code": {
            "type": "string",
            "enum": [
              "REQUIRED",
              "TOO_LONG",
              "TOO_SHORT",
              "OUT_OF_RANGE",
              "TOO_MANY",
              "INVALID_FORMAT",
              "NOT_ALLOWED",
              "CONFLICT",
              "INVALID_ENCODING",
              "INSECURE_SCHEME",
              "UNSAFE_CONTENT",
              "REQUIRED_WHEN_ENABLED"
            ],
            "description": "Machine-readable reason the field failed validation. Optional; clients should fall back to Message when it is absent or unrecognized.",
            "example": "TOO_LONG"
          },
          "Params": {
            "type": "object",
            "additionalProperties": true,
            "description": "Machine-readable values the message is built from, such as limits or allowed values; keys are PascalCase and depend on Code. Optional.",
            "example": {
              "Max": 100
            }
          }
        }
      },
      "listEnrichedHotels_Pagination": {
        "type": "object",
        "required": [
          "Total",
          "Limit",
          "Offset"
        ],
        "description": "Pagination metadata for a list response.",
        "properties": {
          "Total": {
            "type": "integer",
            "description": "Total number of items matching the request across all pages.",
            "example": 128
          },
          "Limit": {
            "type": "integer",
            "description": "Maximum number of items returned in this page (at most 50 for this endpoint).",
            "example": 50
          },
          "Offset": {
            "type": "integer",
            "description": "Number of items skipped before this page.",
            "example": 0
          }
        }
      },
      "listEnrichedHotels_ProjectTagSummary": {
        "type": "object",
        "required": [
          "ID",
          "Name"
        ],
        "description": "A reference to one of this project's internal tags applied to the hotel: the tag id and display name.",
        "properties": {
          "ID": {
            "type": "string",
            "format": "uuid",
            "description": "Unique project tag UUID.",
            "example": "0192fc01-1111-7abc-8def-aaaaaaaaaaaa"
          },
          "Name": {
            "type": "string",
            "description": "Tag display name.",
            "example": "Summer Campaign"
          }
        }
      },
      "listEnrichedHotels_StarsMap": {
        "type": "object",
        "description": "Grades by source, in default's order: project (yours, if set), national, association, canonical (the hotel's own site); new keys may appear. default is always present: the first of these, else the collected rating or 0.",
        "additionalProperties": {
          "$ref": "#/components/schemas/StarsMapEntry"
        }
      },
      "listTags_ErrorDetail": {
        "type": "object",
        "required": [
          "Code",
          "Message"
        ],
        "description": "Error detail containing a machine-readable code and human-readable message.",
        "properties": {
          "Code": {
            "type": "string",
            "description": "Machine-readable error code for programmatic handling.",
            "example": "FORBIDDEN"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable error message.",
            "example": "Project access required"
          },
          "Fields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/listTags_FieldError"
            },
            "description": "Field-level validation errors. Only present for VALIDATION_ERROR responses."
          }
        }
      },
      "listTags_ErrorResponse": {
        "type": "object",
        "required": [
          "Error"
        ],
        "description": "Standard v2 error response wrapper.",
        "properties": {
          "Error": {
            "$ref": "#/components/schemas/listTags_ErrorDetail"
          }
        }
      },
      "listTags_FieldError": {
        "type": "object",
        "required": [
          "Field",
          "Message"
        ],
        "description": "A single field-level validation error.",
        "properties": {
          "Field": {
            "type": "string",
            "description": "Name of the field that failed validation.",
            "example": "Name"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable validation error message for this field.",
            "example": "Name cannot be empty"
          },
          "Code": {
            "type": "string",
            "enum": [
              "REQUIRED",
              "TOO_LONG",
              "TOO_SHORT",
              "OUT_OF_RANGE",
              "TOO_MANY",
              "INVALID_FORMAT",
              "NOT_ALLOWED",
              "CONFLICT",
              "INVALID_ENCODING",
              "INSECURE_SCHEME",
              "UNSAFE_CONTENT",
              "REQUIRED_WHEN_ENABLED"
            ],
            "description": "Machine-readable reason the field failed validation. Optional; clients should fall back to Message when it is absent or unrecognized.",
            "example": "TOO_LONG"
          },
          "Params": {
            "type": "object",
            "additionalProperties": true,
            "description": "Machine-readable values the message is built from, such as limits or allowed values. Keys are PascalCase; which keys are present depends on Code. Optional.",
            "example": {
              "Max": 100
            }
          }
        }
      },
      "listTextTemplates_ErrorDetail": {
        "type": "object",
        "required": [
          "Code",
          "Message"
        ],
        "description": "Error detail containing a machine-readable code and human-readable message.",
        "properties": {
          "Code": {
            "type": "string",
            "description": "Machine-readable error code for programmatic handling.",
            "example": "VALIDATION_ERROR"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable error message.",
            "example": "Request validation failed"
          },
          "Fields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/listTextTemplates_FieldError"
            },
            "description": "Field-level validation errors. Only present for VALIDATION_ERROR responses."
          }
        }
      },
      "listTextTemplates_ErrorResponse": {
        "type": "object",
        "required": [
          "Error"
        ],
        "description": "Standard v2 error response wrapper.",
        "properties": {
          "Error": {
            "$ref": "#/components/schemas/listTextTemplates_ErrorDetail"
          }
        }
      },
      "listTextTemplates_FieldError": {
        "type": "object",
        "required": [
          "Field",
          "Message"
        ],
        "description": "A single field-level validation error.",
        "properties": {
          "Field": {
            "type": "string",
            "description": "Name of the field that failed validation.",
            "example": "Status"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable validation error message for this field.",
            "example": "Status must be 'active' or 'inactive'"
          },
          "Code": {
            "type": "string",
            "enum": [
              "REQUIRED",
              "TOO_LONG",
              "TOO_SHORT",
              "OUT_OF_RANGE",
              "TOO_MANY",
              "INVALID_FORMAT",
              "NOT_ALLOWED",
              "CONFLICT",
              "INVALID_ENCODING",
              "INSECURE_SCHEME",
              "UNSAFE_CONTENT",
              "REQUIRED_WHEN_ENABLED"
            ],
            "description": "Machine-readable reason the field failed validation. Optional; clients should fall back to Message when it is absent or unrecognized.",
            "example": "TOO_LONG"
          },
          "Params": {
            "type": "object",
            "additionalProperties": true,
            "description": "Machine-readable values the message is built from, such as limits or allowed values. Keys are PascalCase; which keys are present depends on Code. Optional.",
            "example": {
              "Max": 100
            }
          }
        }
      },
      "listTextTemplates_Pagination": {
        "type": "object",
        "required": [
          "Total",
          "Limit",
          "Offset"
        ],
        "description": "Pagination metadata for a list response.",
        "properties": {
          "Total": {
            "type": "integer",
            "description": "Total number of templates matching the request, across all pages.",
            "example": 2
          },
          "Limit": {
            "type": "integer",
            "description": "Maximum number of items returned in this page.",
            "example": 50
          },
          "Offset": {
            "type": "integer",
            "description": "Number of items skipped before this page.",
            "example": 0
          }
        }
      },
      "listVisionImages_Compliance": {
        "type": "object",
        "properties": {
          "AIGenerated": {
            "type": "boolean",
            "description": "EU AI Act Art. 50(2) machine-readable marker: `true` when the text content of the enclosing object is AI-generated. Always stated explicitly when the envelope is present.",
            "example": true
          }
        }
      },
      "listVisionImages_ErrorDetail": {
        "type": "object",
        "required": [
          "Code",
          "Message"
        ],
        "description": "Error detail containing a machine-readable code and human-readable message.",
        "properties": {
          "Code": {
            "type": "string",
            "description": "Machine-readable error code for programmatic handling.",
            "example": "VALIDATION_ERROR"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable error message.",
            "example": "Validation failed"
          },
          "Fields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/listVisionImages_FieldError"
            },
            "description": "Field-level validation errors. Only present for VALIDATION_ERROR responses."
          }
        }
      },
      "listVisionImages_ErrorResponse": {
        "type": "object",
        "required": [
          "Error"
        ],
        "description": "Standard v2 error response wrapper.",
        "properties": {
          "Error": {
            "$ref": "#/components/schemas/listVisionImages_ErrorDetail"
          }
        }
      },
      "listVisionImages_FieldError": {
        "type": "object",
        "required": [
          "Field",
          "Message"
        ],
        "description": "A single field-level validation error.",
        "properties": {
          "Field": {
            "type": "string",
            "description": "Name of the field that failed validation.",
            "example": "Status"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable validation error message for this field.",
            "example": "Status must be omitted or one of pending, completed, failed"
          },
          "Code": {
            "type": "string",
            "enum": [
              "REQUIRED",
              "TOO_LONG",
              "TOO_SHORT",
              "OUT_OF_RANGE",
              "TOO_MANY",
              "INVALID_FORMAT",
              "NOT_ALLOWED",
              "CONFLICT",
              "INVALID_ENCODING",
              "INSECURE_SCHEME",
              "UNSAFE_CONTENT",
              "REQUIRED_WHEN_ENABLED"
            ],
            "description": "Machine-readable reason the field failed validation. Optional; clients should fall back to Message when it is absent or unrecognized.",
            "example": "TOO_LONG"
          },
          "Params": {
            "type": "object",
            "additionalProperties": true,
            "description": "Machine-readable values the message is built from, such as limits or allowed values; keys are PascalCase and depend on Code. Optional.",
            "example": {
              "Max": 100
            }
          }
        }
      },
      "listVisionImages_Image": {
        "type": "object",
        "required": [
          "ID",
          "URL"
        ],
        "properties": {
          "ID": {
            "type": "string",
            "format": "uuid",
            "description": "Unique image UUID.",
            "example": "0199b2c4-8e31-77aa-9c02-3f5b71a2d9e4"
          },
          "URL": {
            "type": "string",
            "format": "uri",
            "description": "Image URL.",
            "example": "https://ucarecdn.com/3f0a1d55-8b2c-4e79-9d64-7a1c2b3d4e5f/"
          },
          "Source": {
            "type": "string",
            "description": "Detected provenance of the pixels: `photo`, `render`, `illustration` or `ai_generated`. Omitted when the image carries no provenance assessment.",
            "example": "photo"
          },
          "Category": {
            "type": "string",
            "description": "Vision-derived image category (e.g. exterior, room, pool, restaurant).",
            "example": "room"
          },
          "Features": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Vision-derived feature tags depicted in the image.",
            "example": [
              "sea_view",
              "balcony"
            ]
          },
          "Mood": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Vision-derived mood descriptors.",
            "example": [
              "bright",
              "calm"
            ]
          },
          "Tags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Additional vision-derived tags.",
            "example": [
              "sea_view"
            ]
          },
          "Flags": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Quality / content flags raised by vision analysis. Omitted when empty."
          },
          "AppealScore": {
            "type": "integer",
            "description": "Appeal score from 0 to 100, or -1 when there is no scorer-stamped value and no value above 0, normally because nothing has scored the image yet. -1 is not a score and does not affect image order.",
            "example": 82
          },
          "QualityScore": {
            "type": "integer",
            "description": "Technical quality score from 0 to 100, or -1 when there is no scorer-stamped value and no value above 0, normally because nothing has scored the image yet. -1 is not a score and does not affect image order.",
            "example": 77
          },
          "AppealScoreVersion": {
            "type": "string",
            "description": "Version stamp of the scorer that produced AppealScore, for example `app-v4`; it may name an earlier version. Absent when AppealScore is -1 or a legacy score from before stamps existed.",
            "example": "app-v4"
          },
          "QualityScoreVersion": {
            "type": "string",
            "description": "Version stamp of the scorer that produced QualityScore, for example `qs-v4`; it may name an earlier version. Absent when QualityScore is -1, a legacy score, or a first-seen image's provisional score.",
            "example": "qs-v4"
          },
          "Width": {
            "type": "integer",
            "description": "Image width in pixels.",
            "example": 1600
          },
          "Height": {
            "type": "integer",
            "description": "Image height in pixels.",
            "example": 1067
          },
          "Format": {
            "type": "string",
            "description": "Image format (e.g. jpeg, png, webp).",
            "example": "jpeg"
          },
          "FileSize": {
            "type": "integer",
            "description": "File size in bytes.",
            "example": 412000
          },
          "DominantColor": {
            "type": "string",
            "description": "Dominant color as a hex string.",
            "example": "#2E6F95"
          },
          "BlurHash": {
            "type": "string",
            "description": "BlurHash placeholder string for progressive loading.",
            "example": "LEHV6nWB2yk8pyo0adR*"
          },
          "FileMetadata": {
            "type": "object",
            "description": "What the image file itself states in its embedded IPTC/EXIF/XMP metadata: capture date and copyright notice. Omitted when the file states neither; inside it, a value the file did not state has no key.",
            "properties": {
              "CaptureDate": {
                "type": "string",
                "pattern": "^\\d{4}(-\\d{2}(-\\d{2})?)?$",
                "description": "Date the photograph was taken, at the precision the file stated: `2012-06-14`, `2012-06` or `2012`. It carries no time of day and no timezone.",
                "example": "2012-06-14"
              },
              "Copyright": {
                "type": "string",
                "description": "The copyright notice the file carries, as the file wrote it. It names who to ask; it is not a machine-readable licence.",
                "example": "© 2012 Hotel Sol S.A."
              }
            },
            "example": {
              "CaptureDate": "2012-06-14",
              "Copyright": "© 2012 Hotel Sol S.A."
            }
          },
          "Descriptions": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Neutral alt text describing what the image shows, not marketing copy, keyed by BCP 47 language tag. More locales may be added after an image is first analyzed.",
            "example": {
              "en-US": "Double room with a balcony overlooking the sea.",
              "de-DE": "Doppelzimmer mit Balkon und Meerblick."
            }
          },
          "Compliance": {
            "allOf": [
              {
                "$ref": "#/components/schemas/listVisionImages_Compliance"
              }
            ],
            "description": "EU AI Act Article 50(2) marker for this image. Always present with `AIGenerated` true: the category, features, mood, tags, scores and descriptions are model output, `FileMetadata` is not."
          },
          "Presence": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PresenceDetection"
            },
            "description": "People and animals seen in the image, from the closed vocabulary person, adult, child, animal. Omitted when the image carries no presence measurement."
          },
          "Safety": {
            "type": "object",
            "additionalProperties": {
              "type": "number",
              "format": "float",
              "nullable": true,
              "minimum": 0,
              "maximum": 1
            },
            "description": "Safety confidences keyed by dimension, `Inappropriate` and `OffTopic`, each between 0 and 1 or null. Omitted when the image carries no safety measurement.",
            "example": {
              "Inappropriate": 0.02,
              "OffTopic": null
            }
          },
          "TextDetections": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TextDetection"
            },
            "description": "Texts read off the image, each with its kind. Omitted when the image carries no text measurement."
          },
          "FeatureDetections": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FeatureDetection"
            },
            "description": "The image's features with the confidence measured for each, running parallel to `Features`. Omitted when the image carries no feature measurement."
          },
          "Nudity": {
            "type": "object",
            "description": "Nudity assessment: exposure score, reason and explicit flag, independent of `Safety.Inappropriate`. Omitted when the assessment did not run or the image's `Presence` shows no person.",
            "required": [
              "Score",
              "Reason",
              "Explicit"
            ],
            "properties": {
              "Score": {
                "type": "integer",
                "minimum": 0,
                "maximum": 100,
                "description": "Exposure score from 0 to 100. Anchors: 20 beach or casual wear, 40 standard swimwear, 60 revealing swimwear or lingerie, 80 partial nudity, 100 explicit.",
                "example": 60
              },
              "Reason": {
                "type": "string",
                "description": "One model-written sentence naming what drives the score, at most 240 characters. Not sanitized for markup, so escape it before rendering.",
                "example": "Adult in revealing swimwear by the pool."
              },
              "Explicit": {
                "type": "boolean",
                "description": "True from a score of 90 up. Whether a child is in the picture is answered by `Presence`, not here.",
                "example": false
              }
            }
          }
        }
      },
      "listVisionImages_Pagination": {
        "type": "object",
        "required": [
          "Total",
          "Limit",
          "Offset"
        ],
        "description": "Pagination metadata for a list response.",
        "properties": {
          "Total": {
            "type": "integer",
            "description": "Number of images matching the request across all pages, not the page size. With a `Status` filter it covers your newest 10,000 submissions.",
            "example": 4
          },
          "Limit": {
            "type": "integer",
            "description": "Page size actually applied, after the default and the cap.",
            "example": 50
          },
          "Offset": {
            "type": "integer",
            "description": "Number of images skipped before this page.",
            "example": 0
          }
        }
      },
      "previewText_ErrorDetail": {
        "type": "object",
        "required": [
          "Code",
          "Message"
        ],
        "description": "Error detail containing a machine-readable code and human-readable message.",
        "properties": {
          "Code": {
            "type": "string",
            "description": "Machine-readable error code for programmatic handling.",
            "example": "VALIDATION_ERROR"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable error message.",
            "example": "Request validation failed"
          },
          "Fields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/previewText_FieldError"
            },
            "description": "Field-level validation errors. Only present for VALIDATION_ERROR responses."
          }
        }
      },
      "previewText_ErrorResponse": {
        "type": "object",
        "required": [
          "Error"
        ],
        "description": "Standard v2 error response wrapper.",
        "properties": {
          "Error": {
            "$ref": "#/components/schemas/previewText_ErrorDetail"
          }
        }
      },
      "previewText_FieldError": {
        "type": "object",
        "required": [
          "Field",
          "Message"
        ],
        "description": "A single field-level validation error.",
        "properties": {
          "Field": {
            "type": "string",
            "description": "Name of the field that failed validation.",
            "example": "HotelIDs"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable validation error message for this field.",
            "example": "HotelIDs or TagIDs is required"
          },
          "Code": {
            "type": "string",
            "enum": [
              "REQUIRED",
              "TOO_LONG",
              "TOO_SHORT",
              "OUT_OF_RANGE",
              "TOO_MANY",
              "INVALID_FORMAT",
              "NOT_ALLOWED",
              "CONFLICT",
              "INVALID_ENCODING",
              "INSECURE_SCHEME",
              "UNSAFE_CONTENT",
              "REQUIRED_WHEN_ENABLED"
            ],
            "description": "Machine-readable reason the field failed validation. Optional; clients should fall back to Message when it is absent or unrecognized.",
            "example": "TOO_LONG"
          },
          "Params": {
            "type": "object",
            "additionalProperties": true,
            "description": "Machine-readable values the message is built from, such as limits or allowed values. Keys are PascalCase; which keys are present depends on Code. Optional.",
            "example": {
              "Max": 100
            }
          }
        }
      },
      "removeTagFromHotels_BulkTagHotelResult": {
        "type": "object",
        "required": [
          "HotelID",
          "Status"
        ],
        "description": "The outcome for one hotel in a bulk remove.",
        "properties": {
          "HotelID": {
            "type": "string",
            "description": "The hotel id from the request (echoed verbatim, so an invalid id appears as submitted).",
            "example": "0192fb17-5dc6-7abc-8def-123456789abc"
          },
          "Status": {
            "type": "string",
            "enum": [
              "removed",
              "invalid"
            ],
            "description": "Per-hotel outcome: 'removed' (a valid id whose link was removed, or a no-op when no link existed; removal is idempotent) or 'invalid' (a malformed / non-UUID id).",
            "example": "removed"
          }
        }
      },
      "removeTagFromHotels_BulkTagResult": {
        "type": "object",
        "required": [
          "TagID",
          "Results"
        ],
        "description": "The per-hotel outcomes of a bulk remove.",
        "properties": {
          "TagID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the tag that was removed.",
            "example": "0192fc01-1111-7abc-8def-aaaaaaaaaaaa"
          },
          "Results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/removeTagFromHotels_BulkTagHotelResult"
            },
            "description": "One entry per submitted hotel id, in submission order."
          }
        }
      },
      "removeTagFromHotels_ErrorDetail": {
        "type": "object",
        "required": [
          "Code",
          "Message"
        ],
        "description": "Error detail containing a machine-readable code and human-readable message.",
        "properties": {
          "Code": {
            "type": "string",
            "description": "Machine-readable error code for programmatic handling.",
            "example": "VALIDATION_ERROR"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable error message.",
            "example": "Request validation failed"
          },
          "Fields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/removeTagFromHotels_FieldError"
            },
            "description": "Field-level validation errors. Only present for VALIDATION_ERROR responses."
          }
        }
      },
      "removeTagFromHotels_ErrorResponse": {
        "type": "object",
        "required": [
          "Error"
        ],
        "description": "Standard v2 error response wrapper.",
        "properties": {
          "Error": {
            "$ref": "#/components/schemas/removeTagFromHotels_ErrorDetail"
          }
        }
      },
      "removeTagFromHotels_FieldError": {
        "type": "object",
        "required": [
          "Field",
          "Message"
        ],
        "description": "A single field-level validation error.",
        "properties": {
          "Field": {
            "type": "string",
            "description": "Name of the field that failed validation.",
            "example": "HotelIDs"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable validation error message for this field.",
            "example": "HotelIDs must not be empty"
          },
          "Code": {
            "type": "string",
            "enum": [
              "REQUIRED",
              "TOO_LONG",
              "TOO_SHORT",
              "OUT_OF_RANGE",
              "TOO_MANY",
              "INVALID_FORMAT",
              "NOT_ALLOWED",
              "CONFLICT",
              "INVALID_ENCODING",
              "INSECURE_SCHEME",
              "UNSAFE_CONTENT",
              "REQUIRED_WHEN_ENABLED"
            ],
            "description": "Machine-readable reason the field failed validation. Optional; clients should fall back to Message when it is absent or unrecognized.",
            "example": "TOO_LONG"
          },
          "Params": {
            "type": "object",
            "additionalProperties": true,
            "description": "Machine-readable values the message is built from, such as limits or allowed values. Keys are PascalCase; which keys are present depends on Code. Optional.",
            "example": {
              "Max": 100
            }
          }
        }
      },
      "revokeApprovalLink_ApprovalLink": {
        "type": "object",
        "required": [
          "HotelID",
          "HotelName",
          "TokenPreview",
          "Status",
          "RevokedAt",
          "Created",
          "CreatedAt",
          "UpdatedAt"
        ],
        "description": "One hotel's approval link and its state. The same shape is returned by createApprovalLinks, rotateApprovalLink, revokeApprovalLink and listApprovals. NOTE: this response never carries the full `Token` — the revoked token is dead and resolves nothing. Use `TokenPreview` for display; createApprovalLinks returns a full token again once it mints a fresh link.",
        "properties": {
          "HotelID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the hotel this link belongs to.",
            "example": "019d9c2e-0ef8-7458-b0fa-8bed7182eb30"
          },
          "HotelName": {
            "type": "string",
            "description": "Display name of the hotel.",
            "example": "Sotavento Beach Club"
          },
          "GiataID": {
            "type": "integer",
            "description": "The hotel's GIATA id. Omitted when the hotel has none.",
            "example": 5721
          },
          "MasterCode": {
            "type": "string",
            "description": "The calling project's master code for this hotel. Omitted when the project has no code for it.",
            "example": "FUED0009"
          },
          "TokenPreview": {
            "type": "string",
            "description": "Display form of the token: its first 8 characters followed by an ellipsis. Never enough to reconstruct the link.",
            "example": "xPBOjXHo..."
          },
          "Status": {
            "type": "string",
            "enum": [
              "waiting_for_hotel",
              "feedback_received",
              "feedback_applied",
              "approved"
            ],
            "description": "Approval state of this hotel's link, unchanged by the revoke. `waiting_for_hotel` on creation; any feedback moves it to `feedback_received`; `feedback_applied` is set once the feedback has been worked in; `approved` is never left by a later feedback submission; the one way back to `waiting_for_hotel` is a re-minted link (createApprovalLinks after a revoke), which keeps ApprovedAt, ApprovedTextGeneratedAt and ApprovedBy as the record of the earlier approval.",
            "example": "approved"
          },
          "ApprovedAt": {
            "type": "string",
            "format": "date-time",
            "description": "When the hotel approved (RFC3339). Present once the hotel has ever approved: it is the RECORD of that approval and survives a later revoke and a re-minted link, so it can accompany a `waiting_for_hotel` Status (see createApprovalLinks). Only a fresh approval replaces it.",
            "example": "2026-08-25T18:19:18.860882Z"
          },
          "ApprovedTextGeneratedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Newest generation timestamp across the texts that were approved (RFC3339). Compare it with the hotel's current texts to see whether they changed since the approval. Present once the hotel has ever approved (it survives a revoke and a re-minted link, like ApprovedAt), and omitted then if none of the approved texts carried a timestamp.",
            "example": "2026-08-19T14:14:57.674681Z"
          },
          "ApprovedBy": {
            "allOf": [
              {
                "$ref": "#/components/schemas/ApprovalApprover"
              }
            ],
            "description": "Present once the hotel has ever approved: the record of who signed off, kept across a later revoke and a re-minted link (so it can accompany a `waiting_for_hotel` Status) and replaced only by a fresh approval. The identity is the SNAPSHOT taken at approval time and survives deletion of the contact record (`approved_by` is `ON DELETE SET NULL`; the snapshot columns are not cleared)."
          },
          "LastOpenedAt": {
            "type": "string",
            "format": "date-time",
            "description": "When the approval page was last loaded (RFC3339). Omitted while the link has never been opened.",
            "example": "2026-08-25T18:19:18.966928Z"
          },
          "RevokedAt": {
            "type": "string",
            "format": "date-time",
            "description": "When the link was revoked (RFC3339). Always present on this response, and set to the FIRST revoke's timestamp when the link was already revoked. A link carrying it never carries a `Token`.",
            "example": "2026-08-25T18:19:19.602402Z"
          },
          "Created": {
            "type": "boolean",
            "description": "`true` only when this call minted the link. Always `false` on revokeApprovalLink, rotateApprovalLink and listApprovals.",
            "example": false
          },
          "CreatedBy": {
            "type": "string",
            "description": "Audit identity of who minted the link: a user token records the user's email; a project API key records its project-scoped identity (`project:<project-uuid>`). That is what is STORED; what is RETURNED is gated. The stored identity is an operator identity by construction, so in practice it carries an internal staff email — a contact route, and therefore contact PII on the same footing as `ApprovedBy.Email` and `ApprovedBy.Phone`: it is returned only to a caller presenting a user_ token, and is omitted entirely for a proj_ project token (the key is absent, not an empty string).",
            "example": "editor@example.com"
          },
          "CreatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "When the link was minted (RFC3339).",
            "example": "2026-08-25T18:19:17.522006Z"
          },
          "UpdatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "When the link last changed (RFC3339) — a status transition, an approval, a token rotation, or the revoke.",
            "example": "2026-08-25T18:19:19.602402Z"
          }
        }
      },
      "saveHotelImagePin_ErrorDetail": {
        "type": "object",
        "required": [
          "Code",
          "Message"
        ],
        "description": "Error detail containing a machine-readable code and human-readable message.",
        "properties": {
          "Code": {
            "type": "string",
            "description": "Machine-readable error code for programmatic handling.",
            "example": "VALIDATION_ERROR"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable error message.",
            "example": "Request validation failed"
          },
          "Fields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/saveHotelImagePin_FieldError"
            },
            "description": "Field-level validation errors. Only present for VALIDATION_ERROR responses."
          }
        }
      },
      "saveHotelImagePin_ErrorResponse": {
        "type": "object",
        "required": [
          "Error"
        ],
        "description": "Standard v2 error response wrapper.",
        "properties": {
          "Error": {
            "$ref": "#/components/schemas/saveHotelImagePin_ErrorDetail"
          }
        }
      },
      "saveHotelImagePin_FieldError": {
        "type": "object",
        "required": [
          "Field",
          "Message"
        ],
        "description": "A single field-level validation error.",
        "properties": {
          "Field": {
            "type": "string",
            "description": "Name of the field that failed validation.",
            "example": "ImageID"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable validation error message for this field.",
            "example": "ImageID must be a valid UUID"
          },
          "Code": {
            "type": "string",
            "enum": [
              "REQUIRED",
              "TOO_LONG",
              "TOO_SHORT",
              "OUT_OF_RANGE",
              "TOO_MANY",
              "INVALID_FORMAT",
              "NOT_ALLOWED",
              "CONFLICT",
              "INVALID_ENCODING",
              "INSECURE_SCHEME",
              "UNSAFE_CONTENT",
              "REQUIRED_WHEN_ENABLED"
            ],
            "description": "Machine-readable reason the field failed validation. Optional; clients should fall back to Message when it is absent or unrecognized.",
            "example": "TOO_LONG"
          },
          "Params": {
            "type": "object",
            "additionalProperties": true,
            "description": "Machine-readable values the message is built from, such as limits or allowed values. Keys are PascalCase; which keys are present depends on Code. Optional.",
            "example": {
              "Max": 100
            }
          }
        }
      },
      "saveHotelStars_ErrorDetail": {
        "type": "object",
        "required": [
          "Code",
          "Message"
        ],
        "description": "Error detail containing a machine-readable code and human-readable message.",
        "properties": {
          "Code": {
            "type": "string",
            "description": "Machine-readable error code for programmatic handling.",
            "example": "VALIDATION_ERROR"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable error message.",
            "example": "Request validation failed"
          },
          "Fields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/saveHotelStars_FieldError"
            },
            "description": "Field-level validation errors. Only present for VALIDATION_ERROR responses."
          }
        }
      },
      "saveHotelStars_ErrorResponse": {
        "type": "object",
        "required": [
          "Error"
        ],
        "description": "Standard v2 error response wrapper.",
        "properties": {
          "Error": {
            "$ref": "#/components/schemas/saveHotelStars_ErrorDetail"
          }
        }
      },
      "saveHotelStars_FieldError": {
        "type": "object",
        "required": [
          "Field",
          "Message"
        ],
        "description": "A single field-level validation error.",
        "properties": {
          "Field": {
            "type": "string",
            "description": "Name of the field that failed validation.",
            "example": "Stars"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable validation error message for this field.",
            "example": "Stars must be greater than 0 and at most 10, with at most one decimal"
          },
          "Code": {
            "type": "string",
            "enum": [
              "REQUIRED",
              "TOO_LONG",
              "TOO_SHORT",
              "OUT_OF_RANGE",
              "TOO_MANY",
              "INVALID_FORMAT",
              "NOT_ALLOWED",
              "CONFLICT",
              "INVALID_ENCODING",
              "INSECURE_SCHEME",
              "UNSAFE_CONTENT",
              "REQUIRED_WHEN_ENABLED"
            ],
            "description": "Machine-readable reason the field failed validation. Optional; clients should fall back to Message when it is absent or unrecognized.",
            "example": "TOO_LONG"
          },
          "Params": {
            "type": "object",
            "additionalProperties": true,
            "description": "Machine-readable values the message is built from, such as limits or allowed values. Keys are PascalCase; which keys are present depends on Code. Optional.",
            "example": {
              "Max": 100
            }
          }
        }
      },
      "saveTag_ErrorDetail": {
        "type": "object",
        "required": [
          "Code",
          "Message"
        ],
        "description": "Error detail containing a machine-readable code and human-readable message.",
        "properties": {
          "Code": {
            "type": "string",
            "description": "Machine-readable error code for programmatic handling.",
            "example": "VALIDATION_ERROR"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable error message.",
            "example": "Request validation failed"
          },
          "Fields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/saveTag_FieldError"
            },
            "description": "Field-level validation errors. Only present for VALIDATION_ERROR responses."
          }
        }
      },
      "saveTag_ErrorResponse": {
        "type": "object",
        "required": [
          "Error"
        ],
        "description": "Standard v2 error response wrapper.",
        "properties": {
          "Error": {
            "$ref": "#/components/schemas/saveTag_ErrorDetail"
          }
        }
      },
      "saveTag_FieldError": {
        "type": "object",
        "required": [
          "Field",
          "Message"
        ],
        "description": "A single field-level validation error.",
        "properties": {
          "Field": {
            "type": "string",
            "description": "Name of the field that failed validation.",
            "example": "TagID"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable validation error message for this field.",
            "example": "TagID must be a valid UUID"
          },
          "Code": {
            "type": "string",
            "enum": [
              "REQUIRED",
              "TOO_LONG",
              "TOO_SHORT",
              "OUT_OF_RANGE",
              "TOO_MANY",
              "INVALID_FORMAT",
              "NOT_ALLOWED",
              "CONFLICT",
              "INVALID_ENCODING",
              "INSECURE_SCHEME",
              "UNSAFE_CONTENT",
              "REQUIRED_WHEN_ENABLED"
            ],
            "description": "Machine-readable reason the field failed validation. Optional; clients should fall back to Message when it is absent or unrecognized.",
            "example": "TOO_LONG"
          },
          "Params": {
            "type": "object",
            "additionalProperties": true,
            "description": "Machine-readable values the message is built from, such as limits or allowed values. Keys are PascalCase; which keys are present depends on Code. Optional.",
            "example": {
              "Max": 100
            }
          }
        }
      },
      "saveTextTemplate_ErrorDetail": {
        "type": "object",
        "required": [
          "Code",
          "Message"
        ],
        "description": "Error detail containing a machine-readable code and human-readable message.",
        "properties": {
          "Code": {
            "type": "string",
            "description": "Machine-readable error code for programmatic handling.",
            "example": "VALIDATION_ERROR"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable error message.",
            "example": "Request validation failed"
          },
          "Fields": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/saveTextTemplate_FieldError"
            },
            "description": "Field-level validation errors. Only present for VALIDATION_ERROR responses."
          }
        }
      },
      "saveTextTemplate_ErrorResponse": {
        "type": "object",
        "required": [
          "Error"
        ],
        "description": "Standard v2 error response wrapper.",
        "properties": {
          "Error": {
            "$ref": "#/components/schemas/saveTextTemplate_ErrorDetail"
          }
        }
      },
      "saveTextTemplate_FieldError": {
        "type": "object",
        "required": [
          "Field",
          "Message"
        ],
        "description": "A single field-level validation error.",
        "properties": {
          "Field": {
            "type": "string",
            "description": "Name of the field that failed validation.",
            "example": "TemplateKey"
          },
          "Message": {
            "type": "string",
            "description": "Human-readable validation error message for this field.",
            "example": "TemplateKey is required"
          },
          "Code": {
            "type": "string",
            "enum": [
              "REQUIRED",
              "TOO_LONG",
              "TOO_SHORT",
              "OUT_OF_RANGE",
              "TOO_MANY",
              "INVALID_FORMAT",
              "NOT_ALLOWED",
              "CONFLICT",
              "INVALID_ENCODING",
              "INSECURE_SCHEME",
              "UNSAFE_CONTENT",
              "REQUIRED_WHEN_ENABLED"
            ],
            "description": "Machine-readable reason the field failed validation. Optional; clients should fall back to Message when it is absent or unrecognized.",
            "example": "TOO_LONG"
          },
          "Params": {
            "type": "object",
            "additionalProperties": true,
            "description": "Machine-readable values the message is built from, such as limits or allowed values. Keys are PascalCase; which keys are present depends on Code. Optional.",
            "example": {
              "Max": 100
            }
          }
        }
      },
      "saveTextTemplate_TextTemplate": {
        "type": "object",
        "required": [
          "ID",
          "ProjectID",
          "TemplateKey",
          "EntityType",
          "Instruction",
          "LocaleInstructions",
          "Status",
          "CreatedAt",
          "UpdatedAt"
        ],
        "description": "A project-scoped text template. It controls one generated text per locale for either a hotel or a room, using a default authoring instruction plus optional per-locale instruction overrides.",
        "properties": {
          "ID": {
            "type": "string",
            "format": "uuid",
            "description": "Unique template UUID.",
            "example": "0192fb40-1aa2-7def-9abc-1122334455aa"
          },
          "ProjectID": {
            "type": "string",
            "format": "uuid",
            "description": "UUID of the project that owns this template.",
            "example": "0192fb00-0000-7000-8000-000000000001"
          },
          "TemplateKey": {
            "type": "string",
            "description": "Stable key identifying the template within the project. The generated text for this template is stored under this key (e.g. 'summary', 'room_description'). A key may be namespaced with a leading 'group.' prefix to define a variant within a template group.",
            "example": "summary"
          },
          "Name": {
            "type": "string",
            "description": "Human-readable template name for display. May be empty.",
            "example": "Hotel Summary"
          },
          "EntityType": {
            "type": "string",
            "enum": [
              "hotel",
              "room"
            ],
            "description": "Whether the template produces a hotel-level text or a room-level text.",
            "example": "hotel"
          },
          "Description": {
            "type": "string",
            "description": "Free-text note describing what the template is for. May be empty.",
            "example": "Short marketing summary shown at the top of the hotel page."
          },
          "Instruction": {
            "type": "string",
            "description": "Default authoring instruction that guides text generation when no locale-specific override applies.",
            "example": "Write a concise, factual two-sentence summary highlighting the hotel's location, standout amenity, and overall character. Avoid superlatives."
          },
          "LocaleInstructions": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "Per-locale authoring instructions keyed by BCP 47 language tag (e.g. 'de-DE'). When a locale has an entry here, it overrides the default Instruction for that locale; otherwise the default Instruction is used. An empty object means no per-locale overrides.",
            "example": {
              "de-DE": "Schreibe eine sachliche Zusammenfassung in zwei Saetzen und verwende die Sie-Form."
            }
          },
          "Status": {
            "type": "string",
            "enum": [
              "active",
              "inactive"
            ],
            "description": "Lifecycle status. Only 'active' templates are used during text generation.",
            "example": "active"
          },
          "RenderLayout": {
            "type": "string",
            "enum": [
              "prose",
              "highlights",
              "roomcards",
              "summary"
            ],
            "description": "Optional rendering hint suggesting how a client should display this template's generated text. Empty when no hint is set.",
            "example": "prose"
          },
          "CreatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the template was created (RFC3339).",
            "example": "2026-03-01T08:00:00Z"
          },
          "UpdatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Timestamp when the template was last updated (RFC3339).",
            "example": "2026-04-12T09:15:00Z"
          }
        }
      }
    },
    "parameters": {
      "X-Project-ID": {
        "name": "X-Project-ID",
        "in": "header",
        "required": true,
        "description": "Project UUID. Required for all project-scoped endpoints.",
        "example": "$YGO_PROJECT_ID",
        "schema": {
          "type": "string",
          "format": "uuid"
        }
      }
    },
    "headers": {
      "Retry-After": {
        "description": "Number of seconds to wait before retrying the request. Present on 429 responses.",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "example": 39
        }
      },
      "X-Trace-ID": {
        "description": "Request trace ID for debugging (OpenTelemetry). Include this ID when contacting support about specific requests.",
        "schema": {
          "type": "string",
          "example": "abc123def456ghi789"
        }
      },
      "addTagToHotels_Retry-After": {
        "description": "Number of seconds to wait before retrying the request. Present on 429 responses.",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "example": 30
        }
      },
      "deleteHotelImagePin_Retry-After": {
        "description": "Number of seconds to wait before retrying the request. Present on 429 responses.",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "example": 30
        }
      },
      "deleteHotelStars_Retry-After": {
        "description": "Number of seconds to wait before retrying the request. Present on 429 responses.",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "example": 30
        }
      },
      "deleteTag_Retry-After": {
        "description": "Number of seconds to wait before retrying the request. Present on 429 responses.",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "example": 30
        }
      },
      "deleteVisionImages_Retry-After": {
        "description": "Number of seconds to wait before retrying the request. Present on 429 responses.",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "example": 30
        }
      },
      "generateText_Retry-After": {
        "description": "Number of seconds to wait before retrying the request. Present on 429 responses.",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "example": 30
        }
      },
      "getContentSettings_Retry-After": {
        "description": "Number of seconds to wait before retrying the request. Present on 429 responses.",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "example": 30
        }
      },
      "getEnrichedHotel_Retry-After": {
        "description": "Number of seconds to wait before retrying the request. Present on 429 responses.",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "example": 30
        }
      },
      "getTextGenerationStatus_Retry-After": {
        "description": "Number of seconds to wait before retrying the request. Present on 429 responses.",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "example": 30
        }
      },
      "getVisionImages_Retry-After": {
        "description": "Number of seconds to wait before retrying the request. Present on 429 responses.",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "example": 30
        }
      },
      "ingestVisionImages_Retry-After": {
        "description": "Number of seconds to wait before retrying the request. Present on 429 responses.",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "example": 30
        }
      },
      "listEnrichedHotelSummaries_Retry-After": {
        "description": "Number of seconds to wait before retrying the request. Present on 429 responses.",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "example": 30
        }
      },
      "listEnrichedHotels_Retry-After": {
        "description": "Number of seconds to wait before retrying the request. Present on 429 responses.",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "example": 30
        }
      },
      "listTags_Retry-After": {
        "description": "Number of seconds to wait before retrying the request. Present on 429 responses.",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "example": 30
        }
      },
      "listTextTemplates_Retry-After": {
        "description": "Number of seconds to wait before retrying the request. Present on 429 responses.",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "example": 30
        }
      },
      "listVisionImages_Retry-After": {
        "description": "Number of seconds to wait before retrying the request. Present on 429 responses.",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "example": 30
        }
      },
      "previewText_Retry-After": {
        "description": "Number of seconds to wait before retrying the request. Present on 429 responses.",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "example": 30
        }
      },
      "removeTagFromHotels_Retry-After": {
        "description": "Number of seconds to wait before retrying the request. Present on 429 responses.",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "example": 30
        }
      },
      "saveHotelImagePin_Retry-After": {
        "description": "Number of seconds to wait before retrying the request. Present on 429 responses.",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "example": 30
        }
      },
      "saveHotelStars_Retry-After": {
        "description": "Number of seconds to wait before retrying the request. Present on 429 responses.",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "example": 30
        }
      },
      "saveTag_Retry-After": {
        "description": "Number of seconds to wait before retrying the request. Present on 429 responses.",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "example": 30
        }
      },
      "saveTextTemplate_Retry-After": {
        "description": "Number of seconds to wait before retrying the request. Present on 429 responses.",
        "schema": {
          "type": "integer",
          "minimum": 1,
          "example": 30
        }
      }
    },
    "responses": {
      "BadRequest": {
        "description": "Bad Request - the request body or the X-Project-ID header failed validation, the upload cannot be accepted as stored (`VALIDATION_ERROR` on `FeedbackID`), or the upload or the project is in a state that refuses the accept (`INVALID_STATUS_TRANSITION`: hotel photo uploads not enabled or switched off for the project, an upload whose stored photo record is incomplete, an upload already decided, or a photo list that changed or is full).",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "missingProjectHeader": {
                "summary": "X-Project-ID header missing",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "X-Project-ID header is required"
                  }
                }
              },
              "invalidBody": {
                "summary": "Malformed request body",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid request body"
                  }
                }
              },
              "invalidHotelID": {
                "summary": "HotelID missing or not a valid UUID",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "HotelID",
                        "Message": "HotelID must be a valid UUID"
                      }
                    ]
                  }
                }
              },
              "invalidFeedbackID": {
                "summary": "FeedbackID missing or not a valid UUID",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "FeedbackID",
                        "Message": "FeedbackID must be a valid UUID"
                      }
                    ]
                  }
                }
              },
              "uploadsNotEnabled": {
                "summary": "Hotel photo uploads are not enabled for the project",
                "value": {
                  "Error": {
                    "Code": "INVALID_STATUS_TRANSITION",
                    "Message": "Accepted photos cannot be shown for this project yet. Please ask YGO support to enable hotel photo uploads for it."
                  }
                }
              },
              "uploadsSwitchedOff": {
                "summary": "Hotel photo uploads are switched off for the project",
                "value": {
                  "Error": {
                    "Code": "INVALID_STATUS_TRANSITION",
                    "Message": "Accepted photos are currently switched off for this project. Please contact YGO support."
                  }
                }
              },
              "uploadUnreadable": {
                "summary": "The upload's stored photo record is incomplete and cannot be read",
                "value": {
                  "Error": {
                    "Code": "INVALID_STATUS_TRANSITION",
                    "Message": "This upload cannot be reviewed: its photo record is incomplete. Please contact YGO support."
                  }
                }
              },
              "alreadyReviewed": {
                "summary": "The upload was already accepted or rejected",
                "value": {
                  "Error": {
                    "Code": "INVALID_STATUS_TRANSITION",
                    "Message": "This photo was already reviewed."
                  }
                }
              },
              "listFull": {
                "summary": "The page's list already holds 10 photos",
                "value": {
                  "Error": {
                    "Code": "INVALID_STATUS_TRANSITION",
                    "Message": "This page already shows the maximum number of photos. Please hide a photo first."
                  }
                }
              },
              "listChanged": {
                "summary": "The page's photo list changed after it was read; retry",
                "value": {
                  "Error": {
                    "Code": "INVALID_STATUS_TRANSITION",
                    "Message": "The photos changed in the meantime. Please reload the page."
                  }
                }
              },
              "notOurStore": {
                "summary": "The upload's URL is not an Uploadcare CDN file URL",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "the photo is not stored in this environment's image store, so it cannot be accepted",
                    "Fields": [
                      {
                        "Field": "FeedbackID",
                        "Code": "NOT_ALLOWED",
                        "Message": "the photo is not stored in this environment's image store, so it cannot be accepted"
                      }
                    ]
                  }
                }
              },
              "listNotWritable": {
                "summary": "The page's list holds a photo that can no longer be listed",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "the page's photo list holds an image that can no longer be listed; fix the list before accepting",
                    "Fields": [
                      {
                        "Field": "FeedbackID",
                        "Code": "CONFLICT",
                        "Message": "the page's photo list holds an image that can no longer be listed; fix the list before accepting"
                      }
                    ]
                  }
                }
              }
            }
          }
        }
      },
      "Conflict": {
        "description": "Conflict - nothing this endpoint may serve as approved: the hotel has not approved, its approval recorded no text version, a text of the exported locale was regenerated, added or cleared after the approval, or a text carries an unreadable version stamp, or a text carries one of the export file's own frame markers on a line of its own (under LF, CRLF or a lone CR).",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "notApproved": {
                "summary": "The hotel has no approval link, or its link has not reached `approved`",
                "value": {
                  "Error": {
                    "Code": "NOT_APPROVED",
                    "Message": "Hotel has not approved its catalog text yet"
                  }
                }
              },
              "notApprovedNoVersion": {
                "summary": "Approved, but the approval recorded no text version",
                "value": {
                  "Error": {
                    "Code": "NOT_APPROVED",
                    "Message": "Hotel approved a text that carried no version stamp, so nothing can be exported as approved. Remedy: regenerate the hotel's texts (that stamps them), revoke the link and create a new one, and let the hotel approve again - the version is then recorded and the export opens"
                  }
                }
              },
              "notApprovedTextMoved": {
                "summary": "Approved, but a text of the exported locale was regenerated after the approval",
                "value": {
                  "Error": {
                    "Code": "NOT_APPROVED",
                    "Message": "Hotel's text was regenerated after its approval, so the live text is not the text the hotel approved and nothing can be exported as approved. Remedy: revoke the link and create a new one, and let the hotel approve the current text again - the export then opens"
                  }
                }
              },
              "notApprovedUnreadableStamp": {
                "summary": "Approved, but a text carries a version stamp that cannot be read",
                "value": {
                  "Error": {
                    "Code": "NOT_APPROVED",
                    "Message": "Hotel's text carries a version stamp that cannot be read, so nothing can be said about which version the hotel approved and nothing can be exported as approved. Remedy: regenerate the hotel's texts (that rewrites the stamps), revoke the link and create a new one, and let the hotel approve again - the version is then recorded and the export opens"
                  }
                }
              },
              "notApprovedForgedFrame": {
                "summary": "A text carries one of the file's own frame markers on a line of its own",
                "value": {
                  "Error": {
                    "Code": "NOT_APPROVED",
                    "Message": "Hotel's approved text contains a line that equals one of the export file's own frame markers, so the file could not be delimited safely and nothing can be exported as approved. Remedy: change that text, revoke the link and create a new one, and let the hotel approve again."
                  }
                }
              }
            }
          }
        }
      },
      "Forbidden": {
        "description": "Forbidden - the caller is authenticated but may not act on this project. Also returned with code INSUFFICIENT_SCOPE when the API key does not carry the content.authoring:write permission this endpoint requires.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "insufficientScope": {
                "summary": "Missing required scope",
                "value": {
                  "Error": {
                    "Code": "INSUFFICIENT_SCOPE",
                    "Message": "token lacks scope content.authoring:write"
                  }
                }
              },
              "accessDenied": {
                "summary": "The user token has no editor access to the project",
                "value": {
                  "Error": {
                    "Code": "FORBIDDEN",
                    "Message": "Access denied to project"
                  }
                }
              },
              "noProjectScope": {
                "summary": "The request carries no project scope",
                "value": {
                  "Error": {
                    "Code": "FORBIDDEN",
                    "Message": "Project access required"
                  }
                }
              }
            }
          }
        }
      },
      "InternalServerError": {
        "description": "Internal Server Error - Unexpected server error. Include the X-Trace-ID header value when contacting support.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "reviewFailed": {
                "summary": "The decision could not be stored",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to review the upload"
                  }
                }
              },
              "loadFailed": {
                "summary": "The hotel's approval page could not be loaded",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to load hotel"
                  }
                }
              },
              "membershipFailed": {
                "summary": "Hotel membership could not be verified",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to verify hotel"
                  }
                }
              }
            }
          }
        }
      },
      "NotFound": {
        "description": "Not Found - the project, the hotel or the upload is not reachable for this caller.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "projectNotFound": {
                "summary": "The project does not exist or was deleted (user tokens)",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Project not found"
                  }
                }
              },
              "hotelNotFound": {
                "summary": "The hotel is not a live member of the project",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Hotel not found"
                  }
                }
              },
              "uploadNotFound": {
                "summary": "No upload of this hotel in this project has this id",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Upload not found"
                  }
                }
              }
            }
          }
        }
      },
      "ServiceUnavailable": {
        "description": "Service Unavailable - nothing was written; retry later. The page's ordered photo list could not be read.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "pageDegraded": {
                "summary": "The page's photo list could not be read; nothing was written",
                "value": {
                  "Error": {
                    "Code": "SERVICE_UNAVAILABLE",
                    "Message": "The photos cannot be loaded right now. Please try again shortly."
                  }
                }
              }
            }
          }
        }
      },
      "TooManyRequests": {
        "description": "Too Many Requests. The response includes a `Retry-After` header with the number of seconds to wait before retrying.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          },
          "Retry-After": {
            "$ref": "#/components/headers/Retry-After"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "rateLimited": {
                "summary": "Limit exceeded",
                "value": {
                  "Error": {
                    "Code": "RATE_LIMIT_EXCEEDED",
                    "Message": "Rate limit exceeded. Retry after the number of seconds in the Retry-After header."
                  }
                }
              }
            }
          }
        }
      },
      "Unauthorized": {
        "description": "Unauthorized - Invalid or missing bearer token.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "missingToken": {
                "summary": "No Authorization header",
                "value": {
                  "Error": {
                    "Code": "UNAUTHORIZED",
                    "Message": "Missing bearer token"
                  }
                }
              },
              "invalidToken": {
                "summary": "The bearer token is not valid",
                "value": {
                  "Error": {
                    "Code": "UNAUTHORIZED",
                    "Message": "Invalid bearer token"
                  }
                }
              }
            }
          }
        }
      },
      "addTagToHotels_BadRequest": {
        "description": "Bad Request - Validation error or invalid request body.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/addTagToHotels_ErrorResponse"
            },
            "examples": {
              "invalidTagID": {
                "summary": "TagID missing or not a valid UUID",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Request validation failed",
                    "Fields": [
                      {
                        "Field": "TagID",
                        "Message": "TagID must be a valid UUID"
                      }
                    ]
                  }
                }
              },
              "emptyHotelIDs": {
                "summary": "HotelIDs is empty",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Request validation failed",
                    "Fields": [
                      {
                        "Field": "HotelIDs",
                        "Message": "HotelIDs must not be empty"
                      }
                    ]
                  }
                }
              },
              "tooManyHotelIDs": {
                "summary": "HotelIDs exceeds the maximum of 1000",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Request validation failed",
                    "Fields": [
                      {
                        "Field": "HotelIDs",
                        "Message": "HotelIDs exceeds the maximum of 1000"
                      }
                    ]
                  }
                }
              },
              "invalidBody": {
                "summary": "Malformed request body",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid request body"
                  }
                }
              }
            }
          }
        }
      },
      "addTagToHotels_Forbidden": {
        "description": "Forbidden - Valid API key but insufficient permissions for this operation. Also returned with code INSUFFICIENT_SCOPE when the API key does not carry the content.catalog:write permission this endpoint requires.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/addTagToHotels_ErrorResponse"
            },
            "examples": {
              "insufficientScope": {
                "summary": "Missing required scope",
                "value": {
                  "Error": {
                    "Code": "INSUFFICIENT_SCOPE",
                    "Message": "token lacks scope content.catalog:write"
                  }
                }
              },
              "noProjectAccess": {
                "summary": "Project access required",
                "value": {
                  "Error": {
                    "Code": "FORBIDDEN",
                    "Message": "Project access required"
                  }
                }
              }
            }
          }
        }
      },
      "addTagToHotels_InternalServerError": {
        "description": "Internal Server Error - Unexpected server error. Include the X-Trace-ID header value when contacting support.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/addTagToHotels_ErrorResponse"
            },
            "examples": {
              "internalError": {
                "summary": "Internal server error",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to verify hotel"
                  }
                }
              }
            }
          }
        }
      },
      "addTagToHotels_NotFound": {
        "description": "Not Found - The tag does not exist or is not in the calling project's scope.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/addTagToHotels_ErrorResponse"
            },
            "examples": {
              "tagNotFound": {
                "summary": "Tag id not in the project (foreign tag)",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Tag not found"
                  }
                }
              }
            }
          }
        }
      },
      "addTagToHotels_TooManyRequests": {
        "description": "Too Many Requests. The response includes a `Retry-After` header with the number of seconds to wait before retrying.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          },
          "Retry-After": {
            "$ref": "#/components/headers/addTagToHotels_Retry-After"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/addTagToHotels_ErrorResponse"
            },
            "examples": {
              "rateLimited": {
                "summary": "Limit exceeded",
                "value": {
                  "Error": {
                    "Code": "RATE_LIMIT_EXCEEDED",
                    "Message": "Rate limit exceeded. Retry after the number of seconds in the Retry-After header."
                  }
                }
              }
            }
          }
        }
      },
      "addTagToHotels_Unauthorized": {
        "description": "Unauthorized - Invalid or missing API key.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/addTagToHotels_ErrorResponse"
            },
            "examples": {
              "invalidKey": {
                "summary": "Invalid API key",
                "value": {
                  "Error": {
                    "Code": "UNAUTHORIZED",
                    "Message": "Invalid API key"
                  }
                }
              }
            }
          }
        }
      },
      "createApprovalLinks_BadRequest": {
        "description": "Bad Request - the request body or the X-Project-ID header failed validation.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "missingProjectHeader": {
                "summary": "X-Project-ID header missing",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "X-Project-ID header is required"
                  }
                }
              },
              "invalidBody": {
                "summary": "Malformed request body",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid request body"
                  }
                }
              },
              "missingHotelIDs": {
                "summary": "HotelIDs missing or empty",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "HotelIDs",
                        "Message": "HotelIDs is required"
                      }
                    ]
                  }
                }
              },
              "tooManyHotelIDs": {
                "summary": "More than 500 entries",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "HotelIDs",
                        "Message": "HotelIDs may contain at most 500 entries"
                      }
                    ]
                  }
                }
              },
              "invalidHotelID": {
                "summary": "An entry is not a valid UUID",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "HotelIDs",
                        "Message": "HotelIDs must contain valid UUIDs"
                      }
                    ]
                  }
                }
              }
            }
          }
        }
      },
      "createApprovalLinks_InternalServerError": {
        "description": "Internal Server Error - Unexpected server error. Include the X-Trace-ID header value when contacting support.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "createFailed": {
                "summary": "The links could not be minted",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to create approval links"
                  }
                }
              },
              "membershipFailed": {
                "summary": "Hotel membership could not be verified",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to verify hotels"
                  }
                }
              }
            }
          }
        }
      },
      "createApprovalLinks_NotFound": {
        "description": "Not Found - the project or the hotel is not reachable for this caller.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "projectNotFound": {
                "summary": "The project does not exist or was deleted (user tokens)",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Project not found"
                  }
                }
              },
              "hotelNotFound": {
                "summary": "A hotel could not be resolved while minting",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Hotel not found"
                  }
                }
              }
            }
          }
        }
      },
      "deleteHotelImagePin_BadRequest": {
        "description": "Bad Request - Validation error or invalid request body.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/deleteHotelImagePin_ErrorResponse"
            },
            "examples": {
              "invalidHotelID": {
                "summary": "HotelID missing or not a valid UUID",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Request validation failed",
                    "Fields": [
                      {
                        "Field": "HotelID",
                        "Message": "HotelID must be a valid UUID"
                      }
                    ]
                  }
                }
              },
              "invalidBody": {
                "summary": "Malformed request body",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid request body"
                  }
                }
              }
            }
          }
        }
      },
      "deleteHotelImagePin_Forbidden": {
        "description": "Forbidden - Valid API key but insufficient permissions for this operation. Also returned with code INSUFFICIENT_SCOPE when the API key does not carry the content.catalog:write permission this endpoint requires.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/deleteHotelImagePin_ErrorResponse"
            },
            "examples": {
              "insufficientScope": {
                "summary": "Missing required scope",
                "value": {
                  "Error": {
                    "Code": "INSUFFICIENT_SCOPE",
                    "Message": "token lacks scope content.catalog:write"
                  }
                }
              },
              "noProjectAccess": {
                "summary": "Project access required",
                "value": {
                  "Error": {
                    "Code": "FORBIDDEN",
                    "Message": "Project access required"
                  }
                }
              }
            }
          }
        }
      },
      "deleteHotelImagePin_InternalServerError": {
        "description": "Internal Server Error - Unexpected server error. Include the X-Trace-ID header value when contacting support.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/deleteHotelImagePin_ErrorResponse"
            },
            "examples": {
              "internalError": {
                "summary": "Internal server error",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Internal error"
                  }
                }
              }
            }
          }
        }
      },
      "deleteHotelImagePin_NotFound": {
        "description": "Not Found - The hotel is not in the calling project's scope.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/deleteHotelImagePin_ErrorResponse"
            },
            "examples": {
              "hotelNotFound": {
                "summary": "Hotel not in the project",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Hotel not found"
                  }
                }
              }
            }
          }
        }
      },
      "deleteHotelImagePin_TooManyRequests": {
        "description": "Too Many Requests. The response includes a `Retry-After` header with the number of seconds to wait before retrying.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          },
          "Retry-After": {
            "$ref": "#/components/headers/deleteHotelImagePin_Retry-After"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/deleteHotelImagePin_ErrorResponse"
            },
            "examples": {
              "rateLimited": {
                "summary": "Limit exceeded",
                "value": {
                  "Error": {
                    "Code": "RATE_LIMIT_EXCEEDED",
                    "Message": "Rate limit exceeded. Retry after the number of seconds in the Retry-After header."
                  }
                }
              }
            }
          }
        }
      },
      "deleteHotelImagePin_Unauthorized": {
        "description": "Unauthorized - Invalid or missing API key.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/deleteHotelImagePin_ErrorResponse"
            },
            "examples": {
              "invalidKey": {
                "summary": "Invalid API key",
                "value": {
                  "Error": {
                    "Code": "UNAUTHORIZED",
                    "Message": "Invalid API key"
                  }
                }
              }
            }
          }
        }
      },
      "deleteHotelStars_BadRequest": {
        "description": "Bad Request - Validation error or invalid request body.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/deleteHotelStars_ErrorResponse"
            },
            "examples": {
              "missingHotelID": {
                "summary": "HotelID missing",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "HotelID",
                        "Message": "HotelID is required"
                      }
                    ]
                  }
                }
              },
              "invalidHotelID": {
                "summary": "HotelID is not a valid UUID",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid HotelID format"
                  }
                }
              },
              "invalidBody": {
                "summary": "Malformed request body",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid request body"
                  }
                }
              }
            }
          }
        }
      },
      "deleteHotelStars_Forbidden": {
        "description": "Forbidden - Valid API key but insufficient permissions for this operation. Also returned with code INSUFFICIENT_SCOPE when the API key does not carry the content.catalog:write permission this endpoint requires.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/deleteHotelStars_ErrorResponse"
            },
            "examples": {
              "insufficientScope": {
                "summary": "Missing required scope",
                "value": {
                  "Error": {
                    "Code": "INSUFFICIENT_SCOPE",
                    "Message": "token lacks scope content.catalog:write"
                  }
                }
              },
              "noProjectAccess": {
                "summary": "Project access required",
                "value": {
                  "Error": {
                    "Code": "FORBIDDEN",
                    "Message": "Project access required"
                  }
                }
              }
            }
          }
        }
      },
      "deleteHotelStars_InternalServerError": {
        "description": "Internal Server Error - Unexpected server error. Include the X-Trace-ID header value when contacting support.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/deleteHotelStars_ErrorResponse"
            },
            "examples": {
              "deleteFailed": {
                "summary": "The grade could not be cleared",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to delete project hotel stars"
                  }
                }
              },
              "accessCheckFailed": {
                "summary": "Hotel membership could not be checked",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to verify hotel access"
                  }
                }
              }
            }
          }
        }
      },
      "deleteHotelStars_NotFound": {
        "description": "Not Found - The hotel is not in the calling project's scope, or HotelID is the all-zeros UUID.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/deleteHotelStars_ErrorResponse"
            },
            "examples": {
              "hotelNotFound": {
                "summary": "Hotel not in the project",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Hotel not found"
                  }
                }
              }
            }
          }
        }
      },
      "deleteHotelStars_TooManyRequests": {
        "description": "Too Many Requests. The response includes a `Retry-After` header with the number of seconds to wait before retrying.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          },
          "Retry-After": {
            "$ref": "#/components/headers/deleteHotelStars_Retry-After"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/deleteHotelStars_ErrorResponse"
            },
            "examples": {
              "rateLimited": {
                "summary": "Limit exceeded",
                "value": {
                  "Error": {
                    "Code": "RATE_LIMIT_EXCEEDED",
                    "Message": "Rate limit exceeded. Retry after the number of seconds in the Retry-After header."
                  }
                }
              }
            }
          }
        }
      },
      "deleteHotelStars_Unauthorized": {
        "description": "Unauthorized - Invalid or missing API key.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/deleteHotelStars_ErrorResponse"
            },
            "examples": {
              "invalidKey": {
                "summary": "Invalid API key",
                "value": {
                  "Error": {
                    "Code": "UNAUTHORIZED",
                    "Message": "Invalid API key"
                  }
                }
              }
            }
          }
        }
      },
      "deleteTag_BadRequest": {
        "description": "Bad Request - Validation error or invalid request body.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/deleteTag_ErrorResponse"
            },
            "examples": {
              "invalidTagID": {
                "summary": "TagID missing or not a valid UUID",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Request validation failed",
                    "Fields": [
                      {
                        "Field": "TagID",
                        "Message": "TagID must be a valid UUID"
                      }
                    ]
                  }
                }
              },
              "invalidBody": {
                "summary": "Malformed request body",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid request body"
                  }
                }
              }
            }
          }
        }
      },
      "deleteTag_Forbidden": {
        "description": "Forbidden - Valid API key but insufficient permissions for this operation. Also returned with code INSUFFICIENT_SCOPE when the API key does not carry the content.catalog:write permission this endpoint requires.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/deleteTag_ErrorResponse"
            },
            "examples": {
              "insufficientScope": {
                "summary": "Missing required scope",
                "value": {
                  "Error": {
                    "Code": "INSUFFICIENT_SCOPE",
                    "Message": "token lacks scope content.catalog:write"
                  }
                }
              },
              "noProjectAccess": {
                "summary": "Project access required",
                "value": {
                  "Error": {
                    "Code": "FORBIDDEN",
                    "Message": "Project access required"
                  }
                }
              }
            }
          }
        }
      },
      "deleteTag_InternalServerError": {
        "description": "Internal Server Error - Unexpected server error. Include the X-Trace-ID header value when contacting support.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/deleteTag_ErrorResponse"
            },
            "examples": {
              "internalError": {
                "summary": "Internal server error",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Internal error"
                  }
                }
              }
            }
          }
        }
      },
      "deleteTag_NotFound": {
        "description": "Not Found - The tag does not exist or is not in the calling project's scope.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/deleteTag_ErrorResponse"
            },
            "examples": {
              "tagNotFound": {
                "summary": "Tag id not in the project",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Tag not found"
                  }
                }
              }
            }
          }
        }
      },
      "deleteTag_TooManyRequests": {
        "description": "Too Many Requests. The response includes a `Retry-After` header with the number of seconds to wait before retrying.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          },
          "Retry-After": {
            "$ref": "#/components/headers/deleteTag_Retry-After"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/deleteTag_ErrorResponse"
            },
            "examples": {
              "rateLimited": {
                "summary": "Limit exceeded",
                "value": {
                  "Error": {
                    "Code": "RATE_LIMIT_EXCEEDED",
                    "Message": "Rate limit exceeded. Retry after the number of seconds in the Retry-After header."
                  }
                }
              }
            }
          }
        }
      },
      "deleteTag_Unauthorized": {
        "description": "Unauthorized - Invalid or missing API key.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/deleteTag_ErrorResponse"
            },
            "examples": {
              "invalidKey": {
                "summary": "Invalid API key",
                "value": {
                  "Error": {
                    "Code": "UNAUTHORIZED",
                    "Message": "Invalid API key"
                  }
                }
              }
            }
          }
        }
      },
      "deleteVisionImages_BadRequest": {
        "description": "Bad Request: the request body or an image ID is invalid.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/deleteVisionImages_ErrorResponse"
            },
            "examples": {
              "emptyImageIDs": {
                "summary": "No image IDs provided",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "ImageIDs",
                        "Message": "ImageIDs must contain at least one image id"
                      }
                    ]
                  }
                }
              },
              "tooManyImageIDs": {
                "summary": "More than 100 image IDs in one request",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "ImageIDs",
                        "Message": "ImageIDs cannot exceed 100 entries"
                      }
                    ]
                  }
                }
              },
              "malformedImageID": {
                "summary": "An entry is not a valid UUID",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "ImageIDs[2]",
                        "Message": "ImageID must be a valid UUID"
                      }
                    ]
                  }
                }
              }
            }
          }
        }
      },
      "deleteVisionImages_Forbidden": {
        "description": "Forbidden: the token is a project API key, its user is below org admin, it may not act on this project, or it lacks the `content.catalog:write` permission (`INSUFFICIENT_SCOPE`).",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/deleteVisionImages_ErrorResponse"
            },
            "examples": {
              "insufficientScope": {
                "summary": "Missing required scope",
                "value": {
                  "Error": {
                    "Code": "INSUFFICIENT_SCOPE",
                    "Message": "token lacks scope content.catalog:write"
                  }
                }
              },
              "noProjectAccess": {
                "summary": "Project access required",
                "value": {
                  "Error": {
                    "Code": "FORBIDDEN",
                    "Message": "Project access required"
                  }
                }
              },
              "roleRequired": {
                "summary": "A project (proj_) token or a user below org admin, the most common refusal",
                "value": {
                  "Error": {
                    "Code": "FORBIDDEN",
                    "Message": "Deleting images requires a user token with the org admin role or higher"
                  }
                }
              }
            }
          }
        }
      },
      "deleteVisionImages_InternalServerError": {
        "description": "Internal Server Error: unexpected server error. Quote the `X-Trace-ID` response header when contacting support.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/deleteVisionImages_ErrorResponse"
            },
            "examples": {
              "internalError": {
                "summary": "Internal server error",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to delete images"
                  }
                }
              }
            }
          }
        }
      },
      "deleteVisionImages_NotFound": {
        "description": "Not Found: Vision AI is not enabled for your project, or the project does not exist. An unknown image ID is not a 404; it is reported per image as `not_found`.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/deleteVisionImages_ErrorResponse"
            },
            "examples": {
              "notFound": {
                "summary": "Project or resource not found",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Not found"
                  }
                }
              }
            }
          }
        }
      },
      "deleteVisionImages_TooManyRequests": {
        "description": "Too Many Requests: the rate limit was exceeded. `Retry-After` carries the number of seconds to wait before retrying.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          },
          "Retry-After": {
            "$ref": "#/components/headers/deleteVisionImages_Retry-After"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/deleteVisionImages_ErrorResponse"
            },
            "examples": {
              "rateLimited": {
                "summary": "Limit exceeded",
                "value": {
                  "Error": {
                    "Code": "RATE_LIMIT_EXCEEDED",
                    "Message": "Rate limit exceeded. Retry after the number of seconds in the Retry-After header."
                  }
                }
              }
            }
          }
        }
      },
      "deleteVisionImages_Unauthorized": {
        "description": "Unauthorized: the user token is missing or invalid.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/deleteVisionImages_ErrorResponse"
            },
            "examples": {
              "invalidKey": {
                "summary": "Invalid API key",
                "value": {
                  "Error": {
                    "Code": "UNAUTHORIZED",
                    "Message": "Invalid API key"
                  }
                }
              }
            }
          }
        }
      },
      "exportApprovedHotelText_BadRequest": {
        "description": "Bad Request - the request body or the X-Project-ID header failed validation, or the project has no default locale.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "missingProjectHeader": {
                "summary": "X-Project-ID header missing",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "X-Project-ID header is required"
                  }
                }
              },
              "invalidBody": {
                "summary": "Malformed request body",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid request body"
                  }
                }
              },
              "invalidHotelID": {
                "summary": "HotelID missing or not a valid UUID",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "HotelID",
                        "Message": "HotelID must be a valid UUID"
                      }
                    ]
                  }
                }
              },
              "noDefaultLocale": {
                "summary": "The project has no default locale",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Project has no default locale (Settings.Content.DefaultLocale), so there is no locale to export"
                  }
                }
              }
            }
          }
        }
      },
      "exportApprovedHotelText_Forbidden": {
        "description": "Forbidden - the caller is authenticated but may not act on this project. Also returned with code INSUFFICIENT_SCOPE when the API key does not carry the content.authoring:read permission this endpoint requires.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "accessDenied": {
                "summary": "The user token has no editor access to the project",
                "value": {
                  "Error": {
                    "Code": "FORBIDDEN",
                    "Message": "Access denied to project"
                  }
                }
              },
              "noProjectScope": {
                "summary": "The request carries no project scope",
                "value": {
                  "Error": {
                    "Code": "FORBIDDEN",
                    "Message": "Project access required"
                  }
                }
              },
              "insufficientScope": {
                "summary": "A project token without the content.authoring:read scope",
                "value": {
                  "Error": {
                    "Code": "INSUFFICIENT_SCOPE",
                    "Message": "token lacks scope content.authoring:read"
                  }
                }
              }
            }
          }
        }
      },
      "exportApprovedHotelText_InternalServerError": {
        "description": "Internal Server Error - Unexpected server error. Include the X-Trace-ID header value when contacting support.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "approvalFailed": {
                "summary": "The approval could not be read",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to load approval"
                  }
                }
              },
              "hotelFailed": {
                "summary": "The hotel could not be loaded",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to load hotel"
                  }
                }
              },
              "membershipFailed": {
                "summary": "Hotel membership could not be verified",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to verify hotel"
                  }
                }
              },
              "textsFailed": {
                "summary": "The hotel's generated texts could not be read (the page's texts read degraded); no partial file is served",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to load hotel texts"
                  }
                }
              },
              "noApprovalTime": {
                "summary": "An invariant violation, not a client state: the approval row is marked approved but carries no approval time, which the file's Approved line and its download name are both built from. Corrupt data — no request can cause it or clear it",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Approval record has no approval time"
                  }
                }
              },
              "inputsFailed": {
                "summary": "The hotel's images or identifiers could not be read; no file is certified from a degraded gallery or metadata block. The endpoint description lists every read this covers. The hotel's text and its approval are unaffected, so the remedy is to download again once the failing read recovers",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to load the hotel's images and identifiers"
                  }
                }
              }
            }
          }
        }
      },
      "exportApprovedHotelText_NotFound": {
        "description": "Not Found - the project or the hotel is not reachable for this caller, or the project's default locale has no approved text, or the project's `Content.ApprovalTextKeys` setting hides every text this hotel has in that locale.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "projectNotFound": {
                "summary": "The project does not exist or was deleted (user tokens)",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Project not found"
                  }
                }
              },
              "hotelNotFound": {
                "summary": "The hotel is not a live member of the project",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Hotel not found"
                  }
                }
              },
              "noTextForLocale": {
                "summary": "The hotel has approved, but the project's default locale carries no text",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "No approved text in the project's default locale"
                  }
                }
              }
            }
          }
        }
      },
      "generateText_BadRequest": {
        "description": "Bad Request - Validation error or invalid request body.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/generateText_ErrorResponse"
            },
            "examples": {
              "missingSelection": {
                "summary": "Neither HotelIDs nor TagIDs provided",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Request validation failed",
                    "Fields": [
                      {
                        "Field": "HotelIDs",
                        "Message": "HotelIDs or TagIDs is required"
                      }
                    ]
                  }
                }
              },
              "invalidRegenMode": {
                "summary": "RegenMode not in the allowed set",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "RegenMode must be 'fill_missing' or 'full'"
                  }
                }
              },
              "unknownTemplateKeys": {
                "summary": "One or more template keys are not active templates of the project",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "unknown or inactive template keys: Headline"
                  }
                }
              },
              "tooManyHotels": {
                "summary": "Selection exceeds the per-run cap",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "selection must not exceed 100 hotels"
                  }
                }
              }
            }
          }
        }
      },
      "generateText_Conflict": {
        "description": "Conflict - One or more selected hotels already have a text-generation run in progress.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/generateText_ErrorResponse"
            },
            "examples": {
              "activeRunExists": {
                "summary": "A hotel already has a run in progress",
                "value": {
                  "Error": {
                    "Code": "ALREADY_EXISTS",
                    "Message": "one or more hotels already have a text-generation run in progress"
                  }
                }
              }
            }
          }
        }
      },
      "generateText_Forbidden": {
        "description": "Forbidden - Valid API key but insufficient permissions for this operation. Also returned with code INSUFFICIENT_SCOPE when the API key does not carry the content.generation:write permission this endpoint requires.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/generateText_ErrorResponse"
            },
            "examples": {
              "insufficientScope": {
                "summary": "Missing required scope",
                "value": {
                  "Error": {
                    "Code": "INSUFFICIENT_SCOPE",
                    "Message": "token lacks scope content.generation:write"
                  }
                }
              },
              "noProjectAccess": {
                "summary": "Project access required",
                "value": {
                  "Error": {
                    "Code": "FORBIDDEN",
                    "Message": "Project access required"
                  }
                }
              }
            }
          }
        }
      },
      "generateText_InternalServerError": {
        "description": "Internal Server Error - Unexpected server error. Include the X-Trace-ID header value when contacting support.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/generateText_ErrorResponse"
            },
            "examples": {
              "internalError": {
                "summary": "Internal server error",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to create text-generation run"
                  }
                }
              }
            }
          }
        }
      },
      "generateText_NotFound": {
        "description": "Not Found - One of the selected hotels does not exist or is not in the calling project's scope.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/generateText_ErrorResponse"
            },
            "examples": {
              "hotelNotFound": {
                "summary": "A selected hotel is not in the project",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "hotel not found"
                  }
                }
              }
            }
          }
        }
      },
      "generateText_TooManyRequests": {
        "description": "Too Many Requests. The response includes a `Retry-After` header with the number of seconds to wait before retrying.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          },
          "Retry-After": {
            "$ref": "#/components/headers/generateText_Retry-After"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/generateText_ErrorResponse"
            },
            "examples": {
              "rateLimited": {
                "summary": "Limit exceeded",
                "value": {
                  "Error": {
                    "Code": "RATE_LIMIT_EXCEEDED",
                    "Message": "Rate limit exceeded. Retry after the number of seconds in the Retry-After header."
                  }
                }
              }
            }
          }
        }
      },
      "generateText_Unauthorized": {
        "description": "Unauthorized - Invalid or missing API key.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/generateText_ErrorResponse"
            },
            "examples": {
              "invalidKey": {
                "summary": "Invalid API key",
                "value": {
                  "Error": {
                    "Code": "UNAUTHORIZED",
                    "Message": "Invalid API key"
                  }
                }
              }
            }
          }
        }
      },
      "getContentSettings_BadRequest": {
        "description": "Bad Request - Validation error or invalid request body.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/getContentSettings_ErrorResponse"
            },
            "examples": {
              "missingProjectID": {
                "summary": "X-Project-ID header not provided",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "X-Project-ID is required"
                  }
                }
              },
              "invalidBody": {
                "summary": "Malformed request body",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid request body"
                  }
                }
              }
            }
          }
        }
      },
      "getContentSettings_Forbidden": {
        "description": "Forbidden - Valid API key but insufficient permissions for this operation. Also returned with code INSUFFICIENT_SCOPE when the API key does not carry the content.settings:read permission this endpoint requires.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/getContentSettings_ErrorResponse"
            },
            "examples": {
              "insufficientScope": {
                "summary": "Missing required scope",
                "value": {
                  "Error": {
                    "Code": "INSUFFICIENT_SCOPE",
                    "Message": "token lacks scope content.settings:read"
                  }
                }
              },
              "noProjectAccess": {
                "summary": "Project access required",
                "value": {
                  "Error": {
                    "Code": "FORBIDDEN",
                    "Message": "Project access required"
                  }
                }
              }
            }
          }
        }
      },
      "getContentSettings_InternalServerError": {
        "description": "Internal Server Error - Unexpected server error. Include the X-Trace-ID header value when contacting support.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/getContentSettings_ErrorResponse"
            },
            "examples": {
              "internalError": {
                "summary": "Internal server error",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to read content settings"
                  }
                }
              }
            }
          }
        }
      },
      "getContentSettings_NotFound": {
        "description": "Not Found - The requested resource does not exist or is not in the calling project's scope.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/getContentSettings_ErrorResponse"
            },
            "examples": {
              "notFound": {
                "summary": "Resource not found",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Not found"
                  }
                }
              }
            }
          }
        }
      },
      "getContentSettings_TooManyRequests": {
        "description": "Too Many Requests. The response includes a `Retry-After` header with the number of seconds to wait before retrying.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          },
          "Retry-After": {
            "$ref": "#/components/headers/getContentSettings_Retry-After"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/getContentSettings_ErrorResponse"
            },
            "examples": {
              "rateLimited": {
                "summary": "Limit exceeded",
                "value": {
                  "Error": {
                    "Code": "RATE_LIMIT_EXCEEDED",
                    "Message": "Rate limit exceeded. Retry after the number of seconds in the Retry-After header."
                  }
                }
              }
            }
          }
        }
      },
      "getContentSettings_Unauthorized": {
        "description": "Unauthorized - Invalid or missing API key.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/getContentSettings_ErrorResponse"
            },
            "examples": {
              "invalidKey": {
                "summary": "Invalid API key",
                "value": {
                  "Error": {
                    "Code": "UNAUTHORIZED",
                    "Message": "Invalid API key"
                  }
                }
              }
            }
          }
        }
      },
      "getEnrichedHotel_BadRequest": {
        "description": "Bad Request: the request body failed validation.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/getEnrichedHotel_ErrorResponse"
            },
            "examples": {
              "noSelector": {
                "summary": "No selector provided",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "HotelID",
                        "Message": "Provide exactly one of HotelID, GlobalHotelID, or ExternalHotelID"
                      }
                    ]
                  }
                }
              },
              "multipleSelectors": {
                "summary": "More than one selector provided",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "HotelID",
                        "Message": "Provide exactly one of HotelID, GlobalHotelID, or ExternalHotelID (multiple were provided)"
                      }
                    ]
                  }
                }
              },
              "invalidExternalHotelID": {
                "summary": "Unsupported ExternalHotelID sub-key",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "ExternalHotelID",
                        "Message": "Unsupported ExternalHotelID key: hrs"
                      }
                    ]
                  }
                }
              },
              "emptyExternalHotelID": {
                "summary": "ExternalHotelID has no supported sub-key",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "ExternalHotelID",
                        "Message": "ExternalHotelID must contain at least one supported sub-key"
                      }
                    ]
                  }
                }
              },
              "invalidGiata": {
                "summary": "giata is not a positive number",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "ExternalHotelID",
                        "Message": "ExternalHotelID.giata must be a positive number"
                      }
                    ]
                  }
                }
              },
              "invalidPeakworkGoalID": {
                "summary": "peakworkgoalid is not a positive number",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "ExternalHotelID",
                        "Message": "ExternalHotelID.peakworkgoalid must be a positive number"
                      }
                    ]
                  }
                }
              },
              "invalidHotelID": {
                "summary": "HotelID is not a valid UUID",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid HotelID format"
                  }
                }
              },
              "invalidBody": {
                "summary": "Malformed request body",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid request body"
                  }
                }
              }
            }
          }
        }
      },
      "getEnrichedHotel_Forbidden": {
        "description": "Forbidden: the API key may not act on this project, or does not carry the `content.catalog:read` permission this endpoint requires (`INSUFFICIENT_SCOPE`).",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/getEnrichedHotel_ErrorResponse"
            },
            "examples": {
              "insufficientScope": {
                "summary": "Missing required scope",
                "value": {
                  "Error": {
                    "Code": "INSUFFICIENT_SCOPE",
                    "Message": "token lacks scope content.catalog:read"
                  }
                }
              },
              "noProjectAccess": {
                "summary": "Project access required",
                "value": {
                  "Error": {
                    "Code": "FORBIDDEN",
                    "Message": "Project access required"
                  }
                }
              }
            }
          }
        }
      },
      "getEnrichedHotel_InternalServerError": {
        "description": "Internal Server Error: unexpected server error. Quote the `X-Trace-ID` response header when contacting support.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/getEnrichedHotel_ErrorResponse"
            },
            "examples": {
              "internalError": {
                "summary": "Internal server error",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to load hotel"
                  }
                }
              }
            }
          }
        }
      },
      "getEnrichedHotel_NotFound": {
        "description": "Not Found: the hotel does not exist or is not in your project's scope.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/getEnrichedHotel_ErrorResponse"
            },
            "examples": {
              "hotelNotFound": {
                "summary": "Hotel not found",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Hotel not found"
                  }
                }
              }
            }
          }
        }
      },
      "getEnrichedHotel_TooManyRequests": {
        "description": "Too Many Requests: the rate limit was exceeded. `Retry-After` carries the number of seconds to wait before retrying.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          },
          "Retry-After": {
            "$ref": "#/components/headers/getEnrichedHotel_Retry-After"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/getEnrichedHotel_ErrorResponse"
            },
            "examples": {
              "rateLimited": {
                "summary": "Limit exceeded",
                "value": {
                  "Error": {
                    "Code": "RATE_LIMIT_EXCEEDED",
                    "Message": "Rate limit exceeded. Retry after the number of seconds in the Retry-After header."
                  }
                }
              }
            }
          }
        }
      },
      "getEnrichedHotel_Unauthorized": {
        "description": "Unauthorized: the API key is missing or invalid.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/getEnrichedHotel_ErrorResponse"
            },
            "examples": {
              "invalidKey": {
                "summary": "Invalid API key",
                "value": {
                  "Error": {
                    "Code": "UNAUTHORIZED",
                    "Message": "Invalid API key"
                  }
                }
              }
            }
          }
        }
      },
      "getTextGenerationStatus_BadRequest": {
        "description": "Bad Request - Validation error or invalid request body.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/getTextGenerationStatus_ErrorResponse"
            },
            "examples": {
              "missingRunID": {
                "summary": "RunID not provided",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Request validation failed",
                    "Fields": [
                      {
                        "Field": "RunID",
                        "Message": "RunID is required"
                      }
                    ]
                  }
                }
              },
              "invalidRunID": {
                "summary": "RunID is not a valid UUID",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid RunID format"
                  }
                }
              },
              "invalidBody": {
                "summary": "Malformed request body",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid request body"
                  }
                }
              }
            }
          }
        }
      },
      "getTextGenerationStatus_Forbidden": {
        "description": "Forbidden - Valid API key but insufficient permissions for this operation. Also returned with code INSUFFICIENT_SCOPE when the API key does not carry the content.authoring:read permission this endpoint requires.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/getTextGenerationStatus_ErrorResponse"
            },
            "examples": {
              "insufficientScope": {
                "summary": "Missing required scope",
                "value": {
                  "Error": {
                    "Code": "INSUFFICIENT_SCOPE",
                    "Message": "token lacks scope content.authoring:read"
                  }
                }
              },
              "noProjectAccess": {
                "summary": "Project access required",
                "value": {
                  "Error": {
                    "Code": "FORBIDDEN",
                    "Message": "Project access required"
                  }
                }
              }
            }
          }
        }
      },
      "getTextGenerationStatus_InternalServerError": {
        "description": "Internal Server Error - Unexpected server error. Include the X-Trace-ID header value when contacting support.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/getTextGenerationStatus_ErrorResponse"
            },
            "examples": {
              "internalError": {
                "summary": "Internal server error",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to load text-generation run"
                  }
                }
              }
            }
          }
        }
      },
      "getTextGenerationStatus_NotFound": {
        "description": "Not Found - The run does not exist or is not owned by the calling project.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/getTextGenerationStatus_ErrorResponse"
            },
            "examples": {
              "runNotFound": {
                "summary": "Text-generation run not found",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Text-generation run not found"
                  }
                }
              }
            }
          }
        }
      },
      "getTextGenerationStatus_TooManyRequests": {
        "description": "Too Many Requests. The response includes a `Retry-After` header with the number of seconds to wait before retrying.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          },
          "Retry-After": {
            "$ref": "#/components/headers/getTextGenerationStatus_Retry-After"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/getTextGenerationStatus_ErrorResponse"
            },
            "examples": {
              "rateLimited": {
                "summary": "Limit exceeded",
                "value": {
                  "Error": {
                    "Code": "RATE_LIMIT_EXCEEDED",
                    "Message": "Rate limit exceeded. Retry after the number of seconds in the Retry-After header."
                  }
                }
              }
            }
          }
        }
      },
      "getTextGenerationStatus_Unauthorized": {
        "description": "Unauthorized - Invalid or missing API key.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/getTextGenerationStatus_ErrorResponse"
            },
            "examples": {
              "invalidKey": {
                "summary": "Invalid API key",
                "value": {
                  "Error": {
                    "Code": "UNAUTHORIZED",
                    "Message": "Invalid API key"
                  }
                }
              }
            }
          }
        }
      },
      "getVisionImages_BadRequest": {
        "description": "Bad Request: the request body or an image ID is invalid.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/getVisionImages_ErrorResponse"
            },
            "examples": {
              "emptyImageIDs": {
                "summary": "No image IDs provided",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "ImageIDs",
                        "Message": "ImageIDs must contain at least one image id"
                      }
                    ]
                  }
                }
              },
              "tooManyImageIDs": {
                "summary": "More than 100 image IDs in one request",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "ImageIDs",
                        "Message": "ImageIDs cannot exceed 100 entries"
                      }
                    ]
                  }
                }
              },
              "malformedImageID": {
                "summary": "An entry is not a valid UUID",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "ImageIDs[2]",
                        "Message": "ImageID must be a valid UUID"
                      }
                    ]
                  }
                }
              }
            }
          }
        }
      },
      "getVisionImages_Forbidden": {
        "description": "Forbidden: the API key may not act on this project, or does not carry the `content.catalog:read` permission this endpoint requires (`INSUFFICIENT_SCOPE`).",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/getVisionImages_ErrorResponse"
            },
            "examples": {
              "insufficientScope": {
                "summary": "Missing required scope",
                "value": {
                  "Error": {
                    "Code": "INSUFFICIENT_SCOPE",
                    "Message": "token lacks scope content.catalog:read"
                  }
                }
              },
              "noProjectAccess": {
                "summary": "Project access required",
                "value": {
                  "Error": {
                    "Code": "FORBIDDEN",
                    "Message": "Project access required"
                  }
                }
              }
            }
          }
        }
      },
      "getVisionImages_InternalServerError": {
        "description": "Internal Server Error: unexpected server error. Quote the `X-Trace-ID` response header when contacting support.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/getVisionImages_ErrorResponse"
            },
            "examples": {
              "internalError": {
                "summary": "Internal server error",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to load images"
                  }
                }
              }
            }
          }
        }
      },
      "getVisionImages_NotFound": {
        "description": "Not Found: Vision AI is not enabled for your project, or the project does not exist. An unknown image ID is not a 404; it is reported per image as `not_found`.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/getVisionImages_ErrorResponse"
            },
            "examples": {
              "notFound": {
                "summary": "Project or resource not found",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Not found"
                  }
                }
              }
            }
          }
        }
      },
      "getVisionImages_TooManyRequests": {
        "description": "Too Many Requests: the rate limit was exceeded. `Retry-After` carries the number of seconds to wait before retrying.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          },
          "Retry-After": {
            "$ref": "#/components/headers/getVisionImages_Retry-After"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/getVisionImages_ErrorResponse"
            },
            "examples": {
              "rateLimited": {
                "summary": "Limit exceeded",
                "value": {
                  "Error": {
                    "Code": "RATE_LIMIT_EXCEEDED",
                    "Message": "Rate limit exceeded. Retry after the number of seconds in the Retry-After header."
                  }
                }
              }
            }
          }
        }
      },
      "getVisionImages_Unauthorized": {
        "description": "Unauthorized: the API key is missing or invalid.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/getVisionImages_ErrorResponse"
            },
            "examples": {
              "invalidKey": {
                "summary": "Invalid API key",
                "value": {
                  "Error": {
                    "Code": "UNAUTHORIZED",
                    "Message": "Invalid API key"
                  }
                }
              }
            }
          }
        }
      },
      "ingestVisionImages_BadRequest": {
        "description": "Bad Request: the request body failed validation. No hotel and no image is stored when a request is rejected.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ingestVisionImages_ErrorResponse"
            },
            "examples": {
              "multipleSelectors": {
                "summary": "More than one hotel selector",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "HotelID",
                        "Message": "Provide exactly one of HotelID, GlobalHotelID, or ExternalHotelID (multiple were provided)"
                      }
                    ]
                  }
                }
              },
              "invalidHotelID": {
                "summary": "HotelID is not a valid UUID",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid HotelID format"
                  }
                }
              },
              "invalidGiata": {
                "summary": "The giata sub-key is not a positive number",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "ExternalHotelID",
                        "Message": "ExternalHotelID.giata must be a positive number"
                      }
                    ]
                  }
                }
              },
              "missingHotelName": {
                "summary": "HotelName missing on a submission that names a hotel",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "HotelName",
                        "Message": "HotelName is required"
                      }
                    ]
                  }
                }
              },
              "hotelNameWithoutSelector": {
                "summary": "HotelName sent without a hotel selector",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "HotelName",
                        "Message": "HotelName requires a hotel selector (HotelID, GlobalHotelID or ExternalHotelID); omit it to submit images without a hotel"
                      }
                    ]
                  }
                }
              },
              "tooManyImages": {
                "summary": "More than 100 images in one request",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "Images",
                        "Message": "Images cannot exceed 100 entries"
                      }
                    ]
                  }
                }
              },
              "invalidImageURL": {
                "summary": "An image URL is not an absolute https URL, or a RoomRef is too long",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "Images[3].URL",
                        "Message": "URL must be an absolute https URL"
                      },
                      {
                        "Field": "Images[5].RoomRef",
                        "Message": "RoomRef cannot exceed 200 characters"
                      }
                    ]
                  }
                }
              }
            }
          }
        }
      },
      "ingestVisionImages_Conflict": {
        "description": "Conflict: the GIATA ID is held by a hotel record that is not available for submission.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ingestVisionImages_ErrorResponse"
            },
            "examples": {
              "giataHeld": {
                "summary": "The GIATA ID cannot be used for a submission",
                "value": {
                  "Error": {
                    "Code": "ALREADY_EXISTS",
                    "Message": "GiataID is held by a hotel record that is not available for submission"
                  }
                }
              }
            }
          }
        }
      },
      "ingestVisionImages_Forbidden": {
        "description": "Forbidden: the API key may not act on this project, or does not carry the `content.generation:write` permission this endpoint requires (`INSUFFICIENT_SCOPE`).",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ingestVisionImages_ErrorResponse"
            },
            "examples": {
              "insufficientScope": {
                "summary": "Missing required scope",
                "value": {
                  "Error": {
                    "Code": "INSUFFICIENT_SCOPE",
                    "Message": "token lacks scope content.generation:write"
                  }
                }
              },
              "noProjectAccess": {
                "summary": "Project access required",
                "value": {
                  "Error": {
                    "Code": "FORBIDDEN",
                    "Message": "Project access required"
                  }
                }
              }
            }
          }
        }
      },
      "ingestVisionImages_InternalServerError": {
        "description": "Internal Server Error: unexpected server error. Quote the `X-Trace-ID` response header when contacting support.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ingestVisionImages_ErrorResponse"
            },
            "examples": {
              "internalError": {
                "summary": "Internal server error",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to store images"
                  }
                }
              }
            }
          }
        }
      },
      "ingestVisionImages_NotFound": {
        "description": "Not Found: Vision AI is not enabled for your project, the project does not exist, or the selector matched no hotel you can reach. Nothing is stored.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ingestVisionImages_ErrorResponse"
            },
            "examples": {
              "notFound": {
                "summary": "Project or resource not found",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Not found"
                  }
                }
              },
              "hotelNotFound": {
                "summary": "The selector matched no hotel you can reach, and could not create one",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Hotel not found"
                  }
                }
              }
            }
          }
        }
      },
      "ingestVisionImages_TooManyRequests": {
        "description": "Too Many Requests: a per-project daily cap was reached, 25,000 images or 1,000 new hotels per rolling 24 hours. Nothing is stored or metered, and `Retry-After` carries the seconds to wait.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          },
          "Retry-After": {
            "$ref": "#/components/headers/ingestVisionImages_Retry-After"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ingestVisionImages_ErrorResponse"
            },
            "examples": {
              "rateLimited": {
                "summary": "Limit exceeded",
                "value": {
                  "Error": {
                    "Code": "RATE_LIMIT_EXCEEDED",
                    "Message": "Rate limit exceeded. Retry after the number of seconds in the Retry-After header."
                  }
                }
              },
              "imageCapReached": {
                "summary": "Daily image submission cap reached (25,000 per rolling 24 hours), Retry-After: 3600",
                "value": {
                  "Error": {
                    "Code": "RATE_LIMIT_EXCEEDED",
                    "Message": "Daily image submission limit reached for this project. Retry after the number of seconds in the Retry-After header."
                  }
                }
              },
              "hotelCapReached": {
                "summary": "Daily new-hotel cap reached (1,000 per rolling 24 hours), Retry-After: 3600",
                "value": {
                  "Error": {
                    "Code": "RATE_LIMIT_EXCEEDED",
                    "Message": "Daily new-hotel limit reached for this project. Retry after the number of seconds in the Retry-After header."
                  }
                }
              }
            }
          }
        }
      },
      "ingestVisionImages_Unauthorized": {
        "description": "Unauthorized: the API key is missing or invalid.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ingestVisionImages_ErrorResponse"
            },
            "examples": {
              "invalidKey": {
                "summary": "Invalid API key",
                "value": {
                  "Error": {
                    "Code": "UNAUTHORIZED",
                    "Message": "Invalid API key"
                  }
                }
              }
            }
          }
        }
      },
      "listApprovalImageUploads_BadRequest": {
        "description": "Bad Request - the request body or the X-Project-ID header failed validation.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "missingProjectHeader": {
                "summary": "X-Project-ID header missing",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "X-Project-ID header is required"
                  }
                }
              },
              "invalidBody": {
                "summary": "Malformed request body",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid request body"
                  }
                }
              },
              "invalidHotelID": {
                "summary": "HotelID missing or not a valid UUID",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "HotelID",
                        "Message": "HotelID must be a valid UUID"
                      }
                    ]
                  }
                }
              }
            }
          }
        }
      },
      "listApprovalImageUploads_Forbidden": {
        "description": "Forbidden - the caller is authenticated but may not act on this project. Also returned with code INSUFFICIENT_SCOPE when the API key does not carry the content.authoring:read permission this endpoint requires.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "insufficientScope": {
                "summary": "Missing required scope",
                "value": {
                  "Error": {
                    "Code": "INSUFFICIENT_SCOPE",
                    "Message": "token lacks scope content.authoring:read"
                  }
                }
              },
              "accessDenied": {
                "summary": "The user token has no editor access to the project",
                "value": {
                  "Error": {
                    "Code": "FORBIDDEN",
                    "Message": "Access denied to project"
                  }
                }
              },
              "noProjectScope": {
                "summary": "The request carries no project scope",
                "value": {
                  "Error": {
                    "Code": "FORBIDDEN",
                    "Message": "Project access required"
                  }
                }
              }
            }
          }
        }
      },
      "listApprovalImageUploads_InternalServerError": {
        "description": "Internal Server Error - Unexpected server error. Include the X-Trace-ID header value when contacting support.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "listFailed": {
                "summary": "The uploads could not be read",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to list uploads"
                  }
                }
              },
              "membershipFailed": {
                "summary": "Hotel membership could not be verified",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to verify hotel"
                  }
                }
              }
            }
          }
        }
      },
      "listApprovalImageUploads_NotFound": {
        "description": "Not Found - the project or the hotel is not reachable for this caller.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "projectNotFound": {
                "summary": "The project does not exist or was deleted (user tokens)",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Project not found"
                  }
                }
              },
              "hotelNotFound": {
                "summary": "The hotel is not a live member of the project",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Hotel not found"
                  }
                }
              }
            }
          }
        }
      },
      "listApprovals_BadRequest": {
        "description": "Bad Request - the request body or the X-Project-ID header failed validation.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "missingProjectHeader": {
                "summary": "X-Project-ID header missing",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "X-Project-ID header is required"
                  }
                }
              },
              "invalidBody": {
                "summary": "Malformed request body",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid request body"
                  }
                }
              },
              "negativePaging": {
                "summary": "Limit or Offset is negative",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "Limit",
                        "Message": "Limit and Offset must not be negative"
                      }
                    ]
                  }
                }
              },
              "tooManyHotelIDs": {
                "summary": "More than 500 entries in HotelIDs",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "HotelIDs",
                        "Message": "HotelIDs may contain at most 500 entries"
                      }
                    ]
                  }
                }
              },
              "invalidHotelID": {
                "summary": "An entry in HotelIDs is not a valid UUID",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "HotelIDs",
                        "Message": "HotelIDs must contain valid UUIDs"
                      }
                    ]
                  }
                }
              }
            }
          }
        }
      },
      "listApprovals_Forbidden": {
        "description": "Forbidden - the caller is authenticated but may not act on this project. Also returned with code INSUFFICIENT_SCOPE when the API key does not carry the content.authoring:read permission this endpoint requires.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "insufficientScope": {
                "summary": "Missing required scope",
                "value": {
                  "Error": {
                    "Code": "INSUFFICIENT_SCOPE",
                    "Message": "token lacks scope content.authoring:read"
                  }
                }
              },
              "accessDenied": {
                "summary": "The user token has no editor access to the project",
                "value": {
                  "Error": {
                    "Code": "FORBIDDEN",
                    "Message": "Access denied to project"
                  }
                }
              },
              "noProjectScope": {
                "summary": "The request carries no project scope",
                "value": {
                  "Error": {
                    "Code": "FORBIDDEN",
                    "Message": "Project access required"
                  }
                }
              }
            }
          }
        }
      },
      "listApprovals_InternalServerError": {
        "description": "Internal Server Error - Unexpected server error. Include the X-Trace-ID header value when contacting support.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "listFailed": {
                "summary": "The links could not be listed",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to list approval links"
                  }
                }
              },
              "membershipFailed": {
                "summary": "Hotel membership could not be verified",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to verify hotels"
                  }
                }
              }
            }
          }
        }
      },
      "listApprovals_NotFound": {
        "description": "Not Found - the project or the hotel is not reachable for this caller.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "projectNotFound": {
                "summary": "The project does not exist or was deleted (user tokens)",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Project not found"
                  }
                }
              }
            }
          }
        }
      },
      "listEnrichedHotelSummaries_BadRequest": {
        "description": "Bad Request - Validation error or invalid request body.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/listEnrichedHotelSummaries_ErrorResponse"
            },
            "examples": {
              "invalidTextEnrichmentStatus": {
                "summary": "TextEnrichmentStatus is not a recognized value",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "TextEnrichmentStatus must be 'enriched', 'enriching', or 'none'"
                  }
                }
              },
              "invalidTagID": {
                "summary": "A TagID is not a valid UUID",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid TagID format"
                  }
                }
              },
              "tooManyExternalHotelIDSelectors": {
                "summary": "ExternalHotelIDs has more than the allowed number of selectors",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "ExternalHotelIDs cannot contain more than 100 selectors"
                  }
                }
              },
              "invalidExternalHotelIDSelector": {
                "summary": "An ExternalHotelIDs selector has an unsupported sub-key",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "ExternalHotelIDs",
                        "Message": "Unsupported ExternalHotelIDs key: hrs"
                      }
                    ]
                  }
                }
              },
              "invalidPeakworkGoalID": {
                "summary": "An ExternalHotelIDs selector has a peakworkgoalid that is not a positive number",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "ExternalHotelIDs",
                        "Message": "ExternalHotelIDs.peakworkgoalid must be a positive number"
                      }
                    ]
                  }
                }
              },
              "tooManyHotelIDs": {
                "summary": "HotelIDs has more than the allowed number of ids",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "HotelIDs cannot contain more than 100 ids",
                    "Fields": [
                      {
                        "Field": "HotelIDs",
                        "Message": "HotelIDs cannot contain more than 100 ids"
                      }
                    ]
                  }
                }
              },
              "invalidHotelID": {
                "summary": "A HotelIDs element is not a valid, non-nil UUID",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid HotelIDs format",
                    "Fields": [
                      {
                        "Field": "HotelIDs",
                        "Message": "Invalid HotelIDs format"
                      }
                    ]
                  }
                }
              },
              "invalidSort": {
                "summary": "Sort is not an allowed value",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Sort must be empty or 'feedback_activity'",
                    "Fields": [
                      {
                        "Field": "Sort",
                        "Message": "Sort must be empty or 'feedback_activity'"
                      }
                    ]
                  }
                }
              },
              "invalidBody": {
                "summary": "Malformed request body",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid request body"
                  }
                }
              }
            }
          }
        }
      },
      "listEnrichedHotelSummaries_Forbidden": {
        "description": "Forbidden: the API key may not act on this project, lacks `content.catalog:read` (`INSUFFICIENT_SCOPE`), or sends `Sort` 'feedback_activity' without `content.authoring:read`.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/listEnrichedHotelSummaries_ErrorResponse"
            },
            "examples": {
              "insufficientScope": {
                "summary": "Missing required scope",
                "value": {
                  "Error": {
                    "Code": "INSUFFICIENT_SCOPE",
                    "Message": "token lacks scope content.catalog:read"
                  }
                }
              },
              "insufficientScopeFeedbackSort": {
                "summary": "Sort feedback_activity sent without content.authoring:read",
                "value": {
                  "Error": {
                    "Code": "INSUFFICIENT_SCOPE",
                    "Message": "token lacks scope content.authoring:read"
                  }
                }
              },
              "noProjectAccess": {
                "summary": "Project access required",
                "value": {
                  "Error": {
                    "Code": "FORBIDDEN",
                    "Message": "Project access required"
                  }
                }
              }
            }
          }
        }
      },
      "listEnrichedHotelSummaries_InternalServerError": {
        "description": "Internal Server Error - Unexpected server error. Include the X-Trace-ID header value when contacting support.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/listEnrichedHotelSummaries_ErrorResponse"
            },
            "examples": {
              "internalError": {
                "summary": "Internal server error",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to list hotels"
                  }
                }
              }
            }
          }
        }
      },
      "listEnrichedHotelSummaries_NotFound": {
        "description": "Not Found - A requested tag does not exist or is not in the calling project's scope.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/listEnrichedHotelSummaries_ErrorResponse"
            },
            "examples": {
              "tagNotFound": {
                "summary": "An unknown or foreign tag was supplied in TagIDs",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Tag not found"
                  }
                }
              }
            }
          }
        }
      },
      "listEnrichedHotelSummaries_TooManyRequests": {
        "description": "Too Many Requests. The response includes a `Retry-After` header with the number of seconds to wait before retrying.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          },
          "Retry-After": {
            "$ref": "#/components/headers/listEnrichedHotelSummaries_Retry-After"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/listEnrichedHotelSummaries_ErrorResponse"
            },
            "examples": {
              "rateLimited": {
                "summary": "Limit exceeded",
                "value": {
                  "Error": {
                    "Code": "RATE_LIMIT_EXCEEDED",
                    "Message": "Rate limit exceeded. Retry after the number of seconds in the Retry-After header."
                  }
                }
              }
            }
          }
        }
      },
      "listEnrichedHotelSummaries_Unauthorized": {
        "description": "Unauthorized - Invalid or missing API key.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/listEnrichedHotelSummaries_ErrorResponse"
            },
            "examples": {
              "invalidKey": {
                "summary": "Invalid API key",
                "value": {
                  "Error": {
                    "Code": "UNAUTHORIZED",
                    "Message": "Invalid API key"
                  }
                }
              }
            }
          }
        }
      },
      "listEnrichedHotels_BadRequest": {
        "description": "Bad Request: the request body failed validation.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/listEnrichedHotels_ErrorResponse"
            },
            "examples": {
              "invalidTextEnrichmentStatus": {
                "summary": "TextEnrichmentStatus is not a recognized value",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "TextEnrichmentStatus must be 'enriched', 'enriching', or 'none'"
                  }
                }
              },
              "invalidTagID": {
                "summary": "A TagID is not a valid UUID",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid TagID format"
                  }
                }
              },
              "tooManyExternalHotelIDSelectors": {
                "summary": "ExternalHotelIDs has more than the allowed number of selectors",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "ExternalHotelIDs cannot contain more than 50 selectors"
                  }
                }
              },
              "invalidExternalHotelIDSelector": {
                "summary": "An ExternalHotelIDs selector has an unsupported sub-key",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "ExternalHotelIDs",
                        "Message": "Unsupported ExternalHotelIDs key: hrs"
                      }
                    ]
                  }
                }
              },
              "invalidPeakworkGoalID": {
                "summary": "An ExternalHotelIDs selector has a peakworkgoalid that is not a positive number",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "ExternalHotelIDs",
                        "Message": "ExternalHotelIDs.peakworkgoalid must be a positive number"
                      }
                    ]
                  }
                }
              },
              "invalidBody": {
                "summary": "Malformed request body",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid request body"
                  }
                }
              }
            }
          }
        }
      },
      "listEnrichedHotels_Forbidden": {
        "description": "Forbidden: the API key may not act on this project, or does not carry the `content.catalog:read` permission this endpoint requires (`INSUFFICIENT_SCOPE`).",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/listEnrichedHotels_ErrorResponse"
            },
            "examples": {
              "insufficientScope": {
                "summary": "Missing required scope",
                "value": {
                  "Error": {
                    "Code": "INSUFFICIENT_SCOPE",
                    "Message": "token lacks scope content.catalog:read"
                  }
                }
              },
              "noProjectAccess": {
                "summary": "Project access required",
                "value": {
                  "Error": {
                    "Code": "FORBIDDEN",
                    "Message": "Project access required"
                  }
                }
              }
            }
          }
        }
      },
      "listEnrichedHotels_InternalServerError": {
        "description": "Internal Server Error: unexpected server error. Quote the `X-Trace-ID` response header when contacting support.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/listEnrichedHotels_ErrorResponse"
            },
            "examples": {
              "internalError": {
                "summary": "Internal server error",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to list hotels"
                  }
                }
              }
            }
          }
        }
      },
      "listEnrichedHotels_NotFound": {
        "description": "Not Found: a requested tag does not exist or is not in your project's scope.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/listEnrichedHotels_ErrorResponse"
            },
            "examples": {
              "tagNotFound": {
                "summary": "An unknown or foreign tag was supplied in TagIDs / TagName",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Tag not found"
                  }
                }
              }
            }
          }
        }
      },
      "listEnrichedHotels_TooManyRequests": {
        "description": "Too Many Requests: the rate limit was exceeded. `Retry-After` carries the number of seconds to wait before retrying.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          },
          "Retry-After": {
            "$ref": "#/components/headers/listEnrichedHotels_Retry-After"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/listEnrichedHotels_ErrorResponse"
            },
            "examples": {
              "rateLimited": {
                "summary": "Limit exceeded",
                "value": {
                  "Error": {
                    "Code": "RATE_LIMIT_EXCEEDED",
                    "Message": "Rate limit exceeded. Retry after the number of seconds in the Retry-After header."
                  }
                }
              }
            }
          }
        }
      },
      "listEnrichedHotels_Unauthorized": {
        "description": "Unauthorized: the API key is missing or invalid.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/listEnrichedHotels_ErrorResponse"
            },
            "examples": {
              "invalidKey": {
                "summary": "Invalid API key",
                "value": {
                  "Error": {
                    "Code": "UNAUTHORIZED",
                    "Message": "Invalid API key"
                  }
                }
              }
            }
          }
        }
      },
      "listTags_BadRequest": {
        "description": "Bad Request - Validation error or invalid request body.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/listTags_ErrorResponse"
            },
            "examples": {
              "invalidBody": {
                "summary": "Malformed request body",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid request body"
                  }
                }
              }
            }
          }
        }
      },
      "listTags_Forbidden": {
        "description": "Forbidden - Valid API key but insufficient permissions for this operation. Also returned with code INSUFFICIENT_SCOPE when the API key does not carry the content.catalog:read permission this endpoint requires.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/listTags_ErrorResponse"
            },
            "examples": {
              "insufficientScope": {
                "summary": "Missing required scope",
                "value": {
                  "Error": {
                    "Code": "INSUFFICIENT_SCOPE",
                    "Message": "token lacks scope content.catalog:read"
                  }
                }
              },
              "noProjectAccess": {
                "summary": "Project access required",
                "value": {
                  "Error": {
                    "Code": "FORBIDDEN",
                    "Message": "Project access required"
                  }
                }
              }
            }
          }
        }
      },
      "listTags_InternalServerError": {
        "description": "Internal Server Error - Unexpected server error. Include the X-Trace-ID header value when contacting support.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/listTags_ErrorResponse"
            },
            "examples": {
              "internalError": {
                "summary": "Internal server error",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Internal error"
                  }
                }
              }
            }
          }
        }
      },
      "listTags_TooManyRequests": {
        "description": "Too Many Requests. The response includes a `Retry-After` header with the number of seconds to wait before retrying.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          },
          "Retry-After": {
            "$ref": "#/components/headers/listTags_Retry-After"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/listTags_ErrorResponse"
            },
            "examples": {
              "rateLimited": {
                "summary": "Limit exceeded",
                "value": {
                  "Error": {
                    "Code": "RATE_LIMIT_EXCEEDED",
                    "Message": "Rate limit exceeded. Retry after the number of seconds in the Retry-After header."
                  }
                }
              }
            }
          }
        }
      },
      "listTags_Unauthorized": {
        "description": "Unauthorized - Invalid or missing API key.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/listTags_ErrorResponse"
            },
            "examples": {
              "invalidKey": {
                "summary": "Invalid API key",
                "value": {
                  "Error": {
                    "Code": "UNAUTHORIZED",
                    "Message": "Invalid API key"
                  }
                }
              }
            }
          }
        }
      },
      "listTextTemplates_BadRequest": {
        "description": "Bad Request - Validation error or invalid request body.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/listTextTemplates_ErrorResponse"
            },
            "examples": {
              "invalidStatus": {
                "summary": "Status is not a valid value",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Status must be 'active' or 'inactive'"
                  }
                }
              },
              "invalidEntityType": {
                "summary": "EntityType is not a valid value",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "EntityType must be 'hotel' or 'room'"
                  }
                }
              },
              "invalidBody": {
                "summary": "Malformed request body",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid request body"
                  }
                }
              }
            }
          }
        }
      },
      "listTextTemplates_Forbidden": {
        "description": "Forbidden - Valid API key but insufficient permissions for this operation. Also returned with code INSUFFICIENT_SCOPE when the API key does not carry the content.authoring:read permission this endpoint requires.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/listTextTemplates_ErrorResponse"
            },
            "examples": {
              "insufficientScope": {
                "summary": "Missing required scope",
                "value": {
                  "Error": {
                    "Code": "INSUFFICIENT_SCOPE",
                    "Message": "token lacks scope content.authoring:read"
                  }
                }
              },
              "noProjectAccess": {
                "summary": "Project access required",
                "value": {
                  "Error": {
                    "Code": "FORBIDDEN",
                    "Message": "Project access required"
                  }
                }
              }
            }
          }
        }
      },
      "listTextTemplates_InternalServerError": {
        "description": "Internal Server Error - Unexpected server error. Include the X-Trace-ID header value when contacting support.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/listTextTemplates_ErrorResponse"
            },
            "examples": {
              "internalError": {
                "summary": "Internal server error",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to list text templates"
                  }
                }
              }
            }
          }
        }
      },
      "listTextTemplates_NotFound": {
        "description": "Not Found - The requested resource does not exist or is not in the calling project's scope.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/listTextTemplates_ErrorResponse"
            },
            "examples": {
              "projectNotFound": {
                "summary": "Project not found",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Project not found"
                  }
                }
              }
            }
          }
        }
      },
      "listTextTemplates_TooManyRequests": {
        "description": "Too Many Requests. The response includes a `Retry-After` header with the number of seconds to wait before retrying.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          },
          "Retry-After": {
            "$ref": "#/components/headers/listTextTemplates_Retry-After"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/listTextTemplates_ErrorResponse"
            },
            "examples": {
              "rateLimited": {
                "summary": "Limit exceeded",
                "value": {
                  "Error": {
                    "Code": "RATE_LIMIT_EXCEEDED",
                    "Message": "Rate limit exceeded. Retry after the number of seconds in the Retry-After header."
                  }
                }
              }
            }
          }
        }
      },
      "listTextTemplates_Unauthorized": {
        "description": "Unauthorized - Invalid or missing API key.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/listTextTemplates_ErrorResponse"
            },
            "examples": {
              "invalidKey": {
                "summary": "Invalid API key",
                "value": {
                  "Error": {
                    "Code": "UNAUTHORIZED",
                    "Message": "Invalid API key"
                  }
                }
              }
            }
          }
        }
      },
      "listVisionImages_BadRequest": {
        "description": "Bad Request: the request body or the `Status` value is invalid. `Limit` and `Offset` are clamped to the accepted range, never rejected.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/listVisionImages_ErrorResponse"
            },
            "examples": {
              "invalidStatus": {
                "summary": "Status is not one of the three states",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "Status",
                        "Message": "Status must be omitted or one of pending, completed, failed"
                      }
                    ]
                  }
                }
              },
              "malformedBody": {
                "summary": "The request body is not valid JSON, or a field has the wrong type",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid request body"
                  }
                }
              }
            }
          }
        }
      },
      "listVisionImages_Forbidden": {
        "description": "Forbidden: the API key may not act on this project, or does not carry the `content.catalog:read` permission this endpoint requires (`INSUFFICIENT_SCOPE`).",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/listVisionImages_ErrorResponse"
            },
            "examples": {
              "insufficientScope": {
                "summary": "Missing required scope",
                "value": {
                  "Error": {
                    "Code": "INSUFFICIENT_SCOPE",
                    "Message": "token lacks scope content.catalog:read"
                  }
                }
              },
              "noProjectAccess": {
                "summary": "Project access required",
                "value": {
                  "Error": {
                    "Code": "FORBIDDEN",
                    "Message": "Project access required"
                  }
                }
              }
            }
          }
        }
      },
      "listVisionImages_InternalServerError": {
        "description": "Internal Server Error: unexpected server error. Quote the `X-Trace-ID` response header when contacting support.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/listVisionImages_ErrorResponse"
            },
            "examples": {
              "internalError": {
                "summary": "Internal server error",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to load images"
                  }
                }
              }
            }
          }
        }
      },
      "listVisionImages_NotFound": {
        "description": "Not Found: Vision AI is not enabled for your project, or the project does not exist. A project with no submissions is an empty page, not a 404.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/listVisionImages_ErrorResponse"
            },
            "examples": {
              "notFound": {
                "summary": "Project or resource not found",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Not found"
                  }
                }
              }
            }
          }
        }
      },
      "listVisionImages_TooManyRequests": {
        "description": "Too Many Requests: the rate limit was exceeded. `Retry-After` carries the number of seconds to wait before retrying.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          },
          "Retry-After": {
            "$ref": "#/components/headers/listVisionImages_Retry-After"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/listVisionImages_ErrorResponse"
            },
            "examples": {
              "rateLimited": {
                "summary": "Limit exceeded",
                "value": {
                  "Error": {
                    "Code": "RATE_LIMIT_EXCEEDED",
                    "Message": "Rate limit exceeded. Retry after the number of seconds in the Retry-After header."
                  }
                }
              }
            }
          }
        }
      },
      "listVisionImages_Unauthorized": {
        "description": "Unauthorized: the API key is missing or invalid.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/listVisionImages_ErrorResponse"
            },
            "examples": {
              "invalidKey": {
                "summary": "Invalid API key",
                "value": {
                  "Error": {
                    "Code": "UNAUTHORIZED",
                    "Message": "Invalid API key"
                  }
                }
              }
            }
          }
        }
      },
      "previewText_BadRequest": {
        "description": "Bad Request - Validation error or invalid request body.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/previewText_ErrorResponse"
            },
            "examples": {
              "missingSelection": {
                "summary": "Neither HotelIDs nor TagIDs provided",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Request validation failed",
                    "Fields": [
                      {
                        "Field": "HotelIDs",
                        "Message": "HotelIDs or TagIDs is required"
                      }
                    ]
                  }
                }
              },
              "unknownTemplateKeys": {
                "summary": "One or more template keys are not active templates of the project",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "unknown or inactive template keys: Headline"
                  }
                }
              },
              "tooManyHotels": {
                "summary": "Selection exceeds the per-request cap",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "selection must not exceed 100 hotels"
                  }
                }
              }
            }
          }
        }
      },
      "previewText_Forbidden": {
        "description": "Forbidden - Valid API key but insufficient permissions for this operation. Also returned with code INSUFFICIENT_SCOPE when the API key does not carry the content.generation:write permission this endpoint requires.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/previewText_ErrorResponse"
            },
            "examples": {
              "insufficientScope": {
                "summary": "Missing required scope",
                "value": {
                  "Error": {
                    "Code": "INSUFFICIENT_SCOPE",
                    "Message": "token lacks scope content.generation:write"
                  }
                }
              },
              "noProjectAccess": {
                "summary": "Project access required",
                "value": {
                  "Error": {
                    "Code": "FORBIDDEN",
                    "Message": "Project access required"
                  }
                }
              }
            }
          }
        }
      },
      "previewText_InternalServerError": {
        "description": "Internal Server Error - Unexpected server error. Include the X-Trace-ID header value when contacting support.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/previewText_ErrorResponse"
            },
            "examples": {
              "internalError": {
                "summary": "Internal server error",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to preview text"
                  }
                }
              }
            }
          }
        }
      },
      "previewText_NotFound": {
        "description": "Not Found - One of the selected hotels does not exist or is not in the calling project's scope.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/previewText_ErrorResponse"
            },
            "examples": {
              "hotelNotFound": {
                "summary": "A selected hotel is not in the project",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "hotel not found"
                  }
                }
              }
            }
          }
        }
      },
      "previewText_TooManyRequests": {
        "description": "Too Many Requests. The response includes a `Retry-After` header with the number of seconds to wait before retrying.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          },
          "Retry-After": {
            "$ref": "#/components/headers/previewText_Retry-After"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/previewText_ErrorResponse"
            },
            "examples": {
              "rateLimited": {
                "summary": "Limit exceeded",
                "value": {
                  "Error": {
                    "Code": "RATE_LIMIT_EXCEEDED",
                    "Message": "Rate limit exceeded. Retry after the number of seconds in the Retry-After header."
                  }
                }
              }
            }
          }
        }
      },
      "previewText_Unauthorized": {
        "description": "Unauthorized - Invalid or missing API key.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/previewText_ErrorResponse"
            },
            "examples": {
              "invalidKey": {
                "summary": "Invalid API key",
                "value": {
                  "Error": {
                    "Code": "UNAUTHORIZED",
                    "Message": "Invalid API key"
                  }
                }
              }
            }
          }
        }
      },
      "rejectApprovalImageUpload_BadRequest": {
        "description": "Bad Request - the request body or the X-Project-ID header failed validation, or the upload cannot be decided (`INVALID_STATUS_TRANSITION`: its stored photo record is incomplete, or it was already decided).",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "missingProjectHeader": {
                "summary": "X-Project-ID header missing",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "X-Project-ID header is required"
                  }
                }
              },
              "invalidBody": {
                "summary": "Malformed request body",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid request body"
                  }
                }
              },
              "invalidHotelID": {
                "summary": "HotelID missing or not a valid UUID",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "HotelID",
                        "Message": "HotelID must be a valid UUID"
                      }
                    ]
                  }
                }
              },
              "invalidFeedbackID": {
                "summary": "FeedbackID missing or not a valid UUID",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "FeedbackID",
                        "Message": "FeedbackID must be a valid UUID"
                      }
                    ]
                  }
                }
              },
              "uploadUnreadable": {
                "summary": "The upload's stored photo record is incomplete and cannot be read",
                "value": {
                  "Error": {
                    "Code": "INVALID_STATUS_TRANSITION",
                    "Message": "This upload cannot be reviewed: its photo record is incomplete. Please contact YGO support."
                  }
                }
              },
              "alreadyReviewed": {
                "summary": "The upload was already accepted or rejected",
                "value": {
                  "Error": {
                    "Code": "INVALID_STATUS_TRANSITION",
                    "Message": "This photo was already reviewed."
                  }
                }
              }
            }
          }
        }
      },
      "rejectApprovalImageUpload_InternalServerError": {
        "description": "Internal Server Error - Unexpected server error. Include the X-Trace-ID header value when contacting support.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "reviewFailed": {
                "summary": "The decision could not be stored",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to review the upload"
                  }
                }
              },
              "membershipFailed": {
                "summary": "Hotel membership could not be verified",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to verify hotel"
                  }
                }
              }
            }
          }
        }
      },
      "removeTagFromHotels_BadRequest": {
        "description": "Bad Request - Validation error or invalid request body.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/removeTagFromHotels_ErrorResponse"
            },
            "examples": {
              "invalidTagID": {
                "summary": "TagID missing or not a valid UUID",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Request validation failed",
                    "Fields": [
                      {
                        "Field": "TagID",
                        "Message": "TagID must be a valid UUID"
                      }
                    ]
                  }
                }
              },
              "emptyHotelIDs": {
                "summary": "HotelIDs is empty",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Request validation failed",
                    "Fields": [
                      {
                        "Field": "HotelIDs",
                        "Message": "HotelIDs must not be empty"
                      }
                    ]
                  }
                }
              },
              "tooManyHotelIDs": {
                "summary": "HotelIDs exceeds the maximum of 1000",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Request validation failed",
                    "Fields": [
                      {
                        "Field": "HotelIDs",
                        "Message": "HotelIDs exceeds the maximum of 1000"
                      }
                    ]
                  }
                }
              },
              "invalidBody": {
                "summary": "Malformed request body",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid request body"
                  }
                }
              }
            }
          }
        }
      },
      "removeTagFromHotels_Forbidden": {
        "description": "Forbidden - Valid API key but insufficient permissions for this operation. Also returned with code INSUFFICIENT_SCOPE when the API key does not carry the content.catalog:write permission this endpoint requires.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/removeTagFromHotels_ErrorResponse"
            },
            "examples": {
              "insufficientScope": {
                "summary": "Missing required scope",
                "value": {
                  "Error": {
                    "Code": "INSUFFICIENT_SCOPE",
                    "Message": "token lacks scope content.catalog:write"
                  }
                }
              },
              "noProjectAccess": {
                "summary": "Project access required",
                "value": {
                  "Error": {
                    "Code": "FORBIDDEN",
                    "Message": "Project access required"
                  }
                }
              }
            }
          }
        }
      },
      "removeTagFromHotels_InternalServerError": {
        "description": "Internal Server Error - Unexpected server error. Include the X-Trace-ID header value when contacting support.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/removeTagFromHotels_ErrorResponse"
            },
            "examples": {
              "internalError": {
                "summary": "Internal server error",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Internal error"
                  }
                }
              }
            }
          }
        }
      },
      "removeTagFromHotels_NotFound": {
        "description": "Not Found - The tag does not exist or is not in the calling project's scope.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/removeTagFromHotels_ErrorResponse"
            },
            "examples": {
              "tagNotFound": {
                "summary": "Tag id not in the project (foreign tag)",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Tag not found"
                  }
                }
              }
            }
          }
        }
      },
      "removeTagFromHotels_TooManyRequests": {
        "description": "Too Many Requests. The response includes a `Retry-After` header with the number of seconds to wait before retrying.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          },
          "Retry-After": {
            "$ref": "#/components/headers/removeTagFromHotels_Retry-After"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/removeTagFromHotels_ErrorResponse"
            },
            "examples": {
              "rateLimited": {
                "summary": "Limit exceeded",
                "value": {
                  "Error": {
                    "Code": "RATE_LIMIT_EXCEEDED",
                    "Message": "Rate limit exceeded. Retry after the number of seconds in the Retry-After header."
                  }
                }
              }
            }
          }
        }
      },
      "removeTagFromHotels_Unauthorized": {
        "description": "Unauthorized - Invalid or missing API key.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/removeTagFromHotels_ErrorResponse"
            },
            "examples": {
              "invalidKey": {
                "summary": "Invalid API key",
                "value": {
                  "Error": {
                    "Code": "UNAUTHORIZED",
                    "Message": "Invalid API key"
                  }
                }
              }
            }
          }
        }
      },
      "revokeApprovalLink_BadRequest": {
        "description": "Bad Request - the request body or the X-Project-ID header failed validation.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "missingProjectHeader": {
                "summary": "X-Project-ID header missing",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "X-Project-ID header is required"
                  }
                }
              },
              "invalidBody": {
                "summary": "Malformed request body",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid request body"
                  }
                }
              },
              "invalidHotelID": {
                "summary": "HotelID missing or not a valid UUID",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "HotelID",
                        "Message": "HotelID must be a valid UUID"
                      }
                    ]
                  }
                }
              }
            }
          }
        }
      },
      "revokeApprovalLink_InternalServerError": {
        "description": "Internal Server Error - Unexpected server error. Include the X-Trace-ID header value when contacting support.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "revokeFailed": {
                "summary": "The link could not be revoked",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to revoke approval link"
                  }
                }
              },
              "membershipFailed": {
                "summary": "Hotel membership could not be verified",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to verify hotel"
                  }
                }
              }
            }
          }
        }
      },
      "revokeApprovalLink_NotFound": {
        "description": "Not Found - the project or the hotel is not reachable for this caller.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "projectNotFound": {
                "summary": "The project does not exist or was deleted (user tokens)",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Project not found"
                  }
                }
              },
              "hotelNotFound": {
                "summary": "The hotel is not a live member of the project",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Hotel not found"
                  }
                }
              },
              "linkNotFound": {
                "summary": "The hotel is a member but has no link to revoke",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Approval link not found"
                  }
                }
              }
            }
          }
        }
      },
      "rotateApprovalLink_BadRequest": {
        "description": "Bad Request - the request body or the X-Project-ID header failed validation.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "missingProjectHeader": {
                "summary": "X-Project-ID header missing",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "X-Project-ID header is required"
                  }
                }
              },
              "invalidBody": {
                "summary": "Malformed request body",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid request body"
                  }
                }
              },
              "invalidHotelID": {
                "summary": "HotelID missing or not a valid UUID",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "HotelID",
                        "Message": "HotelID must be a valid UUID"
                      }
                    ]
                  }
                }
              }
            }
          }
        }
      },
      "rotateApprovalLink_InternalServerError": {
        "description": "Internal Server Error - Unexpected server error. Include the X-Trace-ID header value when contacting support.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "rotateFailed": {
                "summary": "The token could not be replaced",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to rotate approval link"
                  }
                }
              },
              "membershipFailed": {
                "summary": "Hotel membership could not be verified",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to verify hotel"
                  }
                }
              }
            }
          }
        }
      },
      "rotateApprovalLink_NotFound": {
        "description": "Not Found - the project or the hotel is not reachable for this caller.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorResponse"
            },
            "examples": {
              "projectNotFound": {
                "summary": "The project does not exist or was deleted (user tokens)",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Project not found"
                  }
                }
              },
              "hotelNotFound": {
                "summary": "The hotel is not a live member of the project",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Hotel not found"
                  }
                }
              },
              "linkNotFound": {
                "summary": "The hotel is a member but has no live link — never minted, or revoked",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Approval link not found"
                  }
                }
              }
            }
          }
        }
      },
      "saveHotelImagePin_BadRequest": {
        "description": "Bad Request - Validation error or invalid request body.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/saveHotelImagePin_ErrorResponse"
            },
            "examples": {
              "invalidHotelID": {
                "summary": "HotelID missing or not a valid UUID",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Request validation failed",
                    "Fields": [
                      {
                        "Field": "HotelID",
                        "Message": "HotelID must be a valid UUID"
                      }
                    ]
                  }
                }
              },
              "invalidImageID": {
                "summary": "ImageID missing or not a valid UUID",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Request validation failed",
                    "Fields": [
                      {
                        "Field": "ImageID",
                        "Message": "ImageID must be a valid UUID"
                      }
                    ]
                  }
                }
              },
              "inactiveImage": {
                "summary": "The image is not active",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Request validation failed",
                    "Fields": [
                      {
                        "Field": "ImageID",
                        "Message": "Image is not active"
                      }
                    ]
                  }
                }
              },
              "roomLevelImage": {
                "summary": "Room-level image while the hotel has hotel-level images",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Request validation failed",
                    "Fields": [
                      {
                        "Field": "ImageID",
                        "Message": "A room-level image cannot be pinned while the hotel has hotel-level images"
                      }
                    ]
                  }
                }
              },
              "invalidBody": {
                "summary": "Malformed request body",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid request body"
                  }
                }
              }
            }
          }
        }
      },
      "saveHotelImagePin_Forbidden": {
        "description": "Forbidden - Valid API key but insufficient permissions for this operation. Also returned with code INSUFFICIENT_SCOPE when the API key does not carry the content.catalog:write permission this endpoint requires.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/saveHotelImagePin_ErrorResponse"
            },
            "examples": {
              "insufficientScope": {
                "summary": "Missing required scope",
                "value": {
                  "Error": {
                    "Code": "INSUFFICIENT_SCOPE",
                    "Message": "token lacks scope content.catalog:write"
                  }
                }
              },
              "noProjectAccess": {
                "summary": "Project access required",
                "value": {
                  "Error": {
                    "Code": "FORBIDDEN",
                    "Message": "Project access required"
                  }
                }
              }
            }
          }
        }
      },
      "saveHotelImagePin_InternalServerError": {
        "description": "Internal Server Error - Unexpected server error. Include the X-Trace-ID header value when contacting support.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/saveHotelImagePin_ErrorResponse"
            },
            "examples": {
              "internalError": {
                "summary": "Internal server error",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Internal error"
                  }
                }
              }
            }
          }
        }
      },
      "saveHotelImagePin_NotFound": {
        "description": "Not Found - The hotel is not in the calling project's scope, or the image does not belong to the hotel.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/saveHotelImagePin_ErrorResponse"
            },
            "examples": {
              "hotelNotFound": {
                "summary": "Hotel not in the project",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Hotel not found"
                  }
                }
              },
              "imageNotFound": {
                "summary": "Image does not exist or belongs to another hotel",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Image not found for this hotel"
                  }
                }
              }
            }
          }
        }
      },
      "saveHotelImagePin_TooManyRequests": {
        "description": "Too Many Requests. The response includes a `Retry-After` header with the number of seconds to wait before retrying.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          },
          "Retry-After": {
            "$ref": "#/components/headers/saveHotelImagePin_Retry-After"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/saveHotelImagePin_ErrorResponse"
            },
            "examples": {
              "rateLimited": {
                "summary": "Limit exceeded",
                "value": {
                  "Error": {
                    "Code": "RATE_LIMIT_EXCEEDED",
                    "Message": "Rate limit exceeded. Retry after the number of seconds in the Retry-After header."
                  }
                }
              }
            }
          }
        }
      },
      "saveHotelImagePin_Unauthorized": {
        "description": "Unauthorized - Invalid or missing API key.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/saveHotelImagePin_ErrorResponse"
            },
            "examples": {
              "invalidKey": {
                "summary": "Invalid API key",
                "value": {
                  "Error": {
                    "Code": "UNAUTHORIZED",
                    "Message": "Invalid API key"
                  }
                }
              }
            }
          }
        }
      },
      "saveHotelStars_BadRequest": {
        "description": "Bad Request - Validation error or invalid request body.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/saveHotelStars_ErrorResponse"
            },
            "examples": {
              "missingHotelID": {
                "summary": "HotelID missing",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Validation failed",
                    "Fields": [
                      {
                        "Field": "HotelID",
                        "Message": "HotelID is required"
                      }
                    ]
                  }
                }
              },
              "invalidHotelID": {
                "summary": "HotelID is not a valid UUID",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid HotelID format"
                  }
                }
              },
              "superiorSent": {
                "summary": "Superior sent: a project grade has no Superior",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "A project grade has no Superior",
                    "Fields": [
                      {
                        "Field": "Superior",
                        "Message": "A project grade has no Superior"
                      }
                    ]
                  }
                }
              },
              "invalidBody": {
                "summary": "Malformed request body",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid request body"
                  }
                }
              },
              "starsOutOfRange": {
                "summary": "Stars missing, below 0.1, above 10, or snapping to 0",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Stars must be greater than 0 and at most 10, with at most one decimal",
                    "Fields": [
                      {
                        "Field": "Stars",
                        "Code": "OUT_OF_RANGE",
                        "Message": "Stars must be greater than 0 and at most 10, with at most one decimal",
                        "Params": {
                          "Min": 0.1,
                          "Max": 10
                        }
                      }
                    ]
                  }
                }
              },
              "starsTooManyDecimals": {
                "summary": "Stars with more than one decimal (no field code)",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Stars must be greater than 0 and at most 10, with at most one decimal",
                    "Fields": [
                      {
                        "Field": "Stars",
                        "Message": "Stars must be greater than 0 and at most 10, with at most one decimal"
                      }
                    ]
                  }
                }
              }
            }
          }
        }
      },
      "saveHotelStars_Forbidden": {
        "description": "Forbidden - Valid API key but insufficient permissions for this operation. Also returned with code INSUFFICIENT_SCOPE when the API key does not carry the content.catalog:write permission this endpoint requires.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/saveHotelStars_ErrorResponse"
            },
            "examples": {
              "insufficientScope": {
                "summary": "Missing required scope",
                "value": {
                  "Error": {
                    "Code": "INSUFFICIENT_SCOPE",
                    "Message": "token lacks scope content.catalog:write"
                  }
                }
              },
              "noProjectAccess": {
                "summary": "Project access required",
                "value": {
                  "Error": {
                    "Code": "FORBIDDEN",
                    "Message": "Project access required"
                  }
                }
              }
            }
          }
        }
      },
      "saveHotelStars_InternalServerError": {
        "description": "Internal Server Error - Unexpected server error. Include the X-Trace-ID header value when contacting support.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/saveHotelStars_ErrorResponse"
            },
            "examples": {
              "saveFailed": {
                "summary": "The grade could not be saved",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to save project hotel stars"
                  }
                }
              },
              "accessCheckFailed": {
                "summary": "Hotel membership could not be checked",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to verify hotel access"
                  }
                }
              }
            }
          }
        }
      },
      "saveHotelStars_NotFound": {
        "description": "Not Found - The hotel is not in the calling project's scope, or HotelID is the all-zeros UUID.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/saveHotelStars_ErrorResponse"
            },
            "examples": {
              "hotelNotFound": {
                "summary": "Hotel not in the project",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Hotel not found"
                  }
                }
              }
            }
          }
        }
      },
      "saveHotelStars_TooManyRequests": {
        "description": "Too Many Requests. The response includes a `Retry-After` header with the number of seconds to wait before retrying.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          },
          "Retry-After": {
            "$ref": "#/components/headers/saveHotelStars_Retry-After"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/saveHotelStars_ErrorResponse"
            },
            "examples": {
              "rateLimited": {
                "summary": "Limit exceeded",
                "value": {
                  "Error": {
                    "Code": "RATE_LIMIT_EXCEEDED",
                    "Message": "Rate limit exceeded. Retry after the number of seconds in the Retry-After header."
                  }
                }
              }
            }
          }
        }
      },
      "saveHotelStars_Unauthorized": {
        "description": "Unauthorized - Invalid or missing API key.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/saveHotelStars_ErrorResponse"
            },
            "examples": {
              "invalidKey": {
                "summary": "Invalid API key",
                "value": {
                  "Error": {
                    "Code": "UNAUTHORIZED",
                    "Message": "Invalid API key"
                  }
                }
              }
            }
          }
        }
      },
      "saveTag_BadRequest": {
        "description": "Bad Request - Validation error or invalid request body.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/saveTag_ErrorResponse"
            },
            "examples": {
              "invalidTagID": {
                "summary": "TagID provided but not a valid UUID",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Request validation failed",
                    "Fields": [
                      {
                        "Field": "TagID",
                        "Message": "TagID must be a valid UUID"
                      }
                    ]
                  }
                }
              },
              "emptyName": {
                "summary": "Name is missing or blank",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Name cannot be empty"
                  }
                }
              },
              "invalidBody": {
                "summary": "Malformed request body",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid request body"
                  }
                }
              }
            }
          }
        }
      },
      "saveTag_Conflict": {
        "description": "Conflict - A tag with this name already exists in the project (case-insensitive).",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/saveTag_ErrorResponse"
            },
            "examples": {
              "duplicateName": {
                "summary": "Duplicate tag name",
                "value": {
                  "Error": {
                    "Code": "ALREADY_EXISTS",
                    "Message": "a tag with this name already exists in this project"
                  }
                }
              }
            }
          }
        }
      },
      "saveTag_Forbidden": {
        "description": "Forbidden - Valid API key but insufficient permissions for this operation. Also returned with code INSUFFICIENT_SCOPE when the API key does not carry the content.catalog:write permission this endpoint requires.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/saveTag_ErrorResponse"
            },
            "examples": {
              "insufficientScope": {
                "summary": "Missing required scope",
                "value": {
                  "Error": {
                    "Code": "INSUFFICIENT_SCOPE",
                    "Message": "token lacks scope content.catalog:write"
                  }
                }
              },
              "noProjectAccess": {
                "summary": "Project access required",
                "value": {
                  "Error": {
                    "Code": "FORBIDDEN",
                    "Message": "Project access required"
                  }
                }
              }
            }
          }
        }
      },
      "saveTag_InternalServerError": {
        "description": "Internal Server Error - Unexpected server error. Include the X-Trace-ID header value when contacting support.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/saveTag_ErrorResponse"
            },
            "examples": {
              "internalError": {
                "summary": "Internal server error",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Internal error"
                  }
                }
              }
            }
          }
        }
      },
      "saveTag_NotFound": {
        "description": "Not Found - The tag to rename does not exist or is not in the calling project's scope.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/saveTag_ErrorResponse"
            },
            "examples": {
              "tagNotFound": {
                "summary": "Tag id not in the project",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Tag not found"
                  }
                }
              }
            }
          }
        }
      },
      "saveTag_TooManyRequests": {
        "description": "Too Many Requests. The response includes a `Retry-After` header with the number of seconds to wait before retrying.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          },
          "Retry-After": {
            "$ref": "#/components/headers/saveTag_Retry-After"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/saveTag_ErrorResponse"
            },
            "examples": {
              "rateLimited": {
                "summary": "Limit exceeded",
                "value": {
                  "Error": {
                    "Code": "RATE_LIMIT_EXCEEDED",
                    "Message": "Rate limit exceeded. Retry after the number of seconds in the Retry-After header."
                  }
                }
              }
            }
          }
        }
      },
      "saveTag_Unauthorized": {
        "description": "Unauthorized - Invalid or missing API key.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/saveTag_ErrorResponse"
            },
            "examples": {
              "invalidKey": {
                "summary": "Invalid API key",
                "value": {
                  "Error": {
                    "Code": "UNAUTHORIZED",
                    "Message": "Invalid API key"
                  }
                }
              }
            }
          }
        }
      },
      "saveTextTemplate_BadRequest": {
        "description": "Bad Request - Validation error or invalid request body.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/saveTextTemplate_ErrorResponse"
            },
            "examples": {
              "missingRequiredFields": {
                "summary": "Required fields not provided",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Request validation failed",
                    "Fields": [
                      {
                        "Field": "TemplateKey",
                        "Message": "TemplateKey is required"
                      },
                      {
                        "Field": "EntityType",
                        "Message": "EntityType is required"
                      },
                      {
                        "Field": "Instruction",
                        "Message": "Instruction is required"
                      }
                    ]
                  }
                }
              },
              "invalidEntityType": {
                "summary": "EntityType is not a valid value",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "EntityType must be 'hotel' or 'room'"
                  }
                }
              },
              "invalidRenderLayout": {
                "summary": "RenderLayout is not a valid value",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "RenderLayout must be one of prose, highlights, roomcards, summary"
                  }
                }
              },
              "invalidBody": {
                "summary": "Malformed request body",
                "value": {
                  "Error": {
                    "Code": "VALIDATION_ERROR",
                    "Message": "Invalid request body"
                  }
                }
              }
            }
          }
        }
      },
      "saveTextTemplate_Conflict": {
        "description": "Conflict - The template could not be saved because it conflicts with the current state of an existing template.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/saveTextTemplate_ErrorResponse"
            },
            "examples": {
              "templateConflict": {
                "summary": "Template conflict",
                "value": {
                  "Error": {
                    "Code": "ALREADY_EXISTS",
                    "Message": "Text template conflicts with an existing template"
                  }
                }
              }
            }
          }
        }
      },
      "saveTextTemplate_Forbidden": {
        "description": "Forbidden - Valid API key but insufficient permissions for this operation. Also returned with code INSUFFICIENT_SCOPE when the API key does not carry both the content.authoring:write and content.generation:write permissions this endpoint requires.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/saveTextTemplate_ErrorResponse"
            },
            "examples": {
              "insufficientScope": {
                "summary": "Missing required scope",
                "value": {
                  "Error": {
                    "Code": "INSUFFICIENT_SCOPE",
                    "Message": "token lacks scope content.generation:write"
                  }
                }
              },
              "noProjectAccess": {
                "summary": "Project access required",
                "value": {
                  "Error": {
                    "Code": "FORBIDDEN",
                    "Message": "Project access required"
                  }
                }
              }
            }
          }
        }
      },
      "saveTextTemplate_InternalServerError": {
        "description": "Internal Server Error - Unexpected server error. Include the X-Trace-ID header value when contacting support.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/saveTextTemplate_ErrorResponse"
            },
            "examples": {
              "internalError": {
                "summary": "Internal server error",
                "value": {
                  "Error": {
                    "Code": "INTERNAL_ERROR",
                    "Message": "Failed to save text template"
                  }
                }
              }
            }
          }
        }
      },
      "saveTextTemplate_NotFound": {
        "description": "Not Found - The requested resource does not exist or is not in the calling project's scope.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/saveTextTemplate_ErrorResponse"
            },
            "examples": {
              "projectNotFound": {
                "summary": "Project not found",
                "value": {
                  "Error": {
                    "Code": "NOT_FOUND",
                    "Message": "Project not found"
                  }
                }
              }
            }
          }
        }
      },
      "saveTextTemplate_TooManyRequests": {
        "description": "Too Many Requests. The response includes a `Retry-After` header with the number of seconds to wait before retrying.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          },
          "Retry-After": {
            "$ref": "#/components/headers/saveTextTemplate_Retry-After"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/saveTextTemplate_ErrorResponse"
            },
            "examples": {
              "rateLimited": {
                "summary": "Limit exceeded",
                "value": {
                  "Error": {
                    "Code": "RATE_LIMIT_EXCEEDED",
                    "Message": "Rate limit exceeded. Retry after the number of seconds in the Retry-After header."
                  }
                }
              }
            }
          }
        }
      },
      "saveTextTemplate_Unauthorized": {
        "description": "Unauthorized - Invalid or missing API key.",
        "headers": {
          "X-Trace-ID": {
            "$ref": "#/components/headers/X-Trace-ID"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/saveTextTemplate_ErrorResponse"
            },
            "examples": {
              "invalidKey": {
                "summary": "Invalid API key",
                "value": {
                  "Error": {
                    "Code": "UNAUTHORIZED",
                    "Message": "Invalid API key"
                  }
                }
              }
            }
          }
        }
      }
    },
    "examples": {
      "EnrichedHotelResult": {
        "summary": "A fully enriched Mallorca-style hotel",
        "value": {
          "Data": {
            "ID": "0192fb17-5dc6-7abc-8def-123456789abc",
            "Name": "Bahia Azul Beach Resort",
            "Names": {
              "en-US": "Bahia Azul Beach Resort",
              "de-DE": "Bahia Azul Strandresort"
            },
            "ExternalHotelIDs": {
              "ProductID": "HTL-MAJ-4711",
              "Giata": "668370",
              "PeakworkGoalID": "864521"
            },
            "GlobalHotelID": "ES-MALLR-K7MP2",
            "Stars": 4.5,
            "StarsMap": {
              "default": {
                "Stars": 4.5,
                "Superior": false,
                "Garni": false
              },
              "project": {
                "Stars": 4.5,
                "Superior": false,
                "Garni": false
              }
            },
            "AccommodationType": "resort",
            "Chain": "Meliá Hotels International",
            "Brand": "Sol by Meliá",
            "Location": {
              "Latitude": 39.5696,
              "Longitude": 2.6502,
              "CountryCode": "ES",
              "Address": {
                "Street": "Carrer de la Mar 12",
                "City": "Palma",
                "CityNames": {
                  "en-US": "Palma",
                  "de-DE": "Palma"
                },
                "State": "Illes Balears",
                "PostalCode": "07015",
                "Phone": "+34 971 000 000",
                "Email": "info@bahia-azul.example"
              }
            },
            "FactualAttributes": [
              {
                "Key": "wifi",
                "Type": "factual",
                "Name": {
                  "en-US": "Free WiFi",
                  "de-DE": "Kostenloses WLAN"
                },
                "Value": "true",
                "ValueType": "boolean",
                "ParentKey": "facilities_and_services",
                "IsFree": true,
                "GTCodes": [
                  "GT03-INTE",
                  "AT03-FRCH"
                ]
              },
              {
                "Key": "parking",
                "Type": "factual",
                "Name": {
                  "en-US": "Parking",
                  "de-DE": "Parkplatz"
                },
                "Value": "true",
                "ValueType": "boolean",
                "ParentKey": "facilities_and_services",
                "IsFree": false,
                "GTCodes": [
                  "GT03-CAPA",
                  "AT03-EXCO"
                ]
              },
              {
                "Key": "golf_course",
                "Type": "factual",
                "Name": {
                  "en-US": "Golf course",
                  "de-DE": "Golfplatz"
                },
                "Value": "true",
                "ValueType": "boolean",
                "ParentKey": "leisure_and_wellness",
                "IsFree": null,
                "GTCodes": [
                  "GT03-GOLF"
                ],
                "IsOnSite": false
              },
              {
                "Key": "restaurant",
                "Type": "factual",
                "Name": {
                  "en-US": "Restaurants",
                  "de-DE": "Restaurants"
                },
                "ValueType": "group",
                "ParentKey": "food_and_drink",
                "IsFree": null,
                "GTCodes": [
                  "GT03-REST"
                ],
                "Instances": [
                  {
                    "Name": "La Marea",
                    "Details": {
                      "description": "Mediterranean a la carte restaurant with sea views.",
                      "hours": "19:00-23:00"
                    }
                  },
                  {
                    "Name": "Buffet Central",
                    "Details": {
                      "description": "Main buffet restaurant serving breakfast, lunch and dinner."
                    }
                  }
                ]
              }
            ],
            "POIs": [
              {
                "ID": "0192fb20-1aa2-7def-9abc-3344556677cc",
                "Name": {
                  "en-US": "Es Portitxol",
                  "de-DE": "Es Portitxol"
                },
                "Type": "attraction",
                "IsArea": true,
                "InArea": true
              },
              {
                "ID": "0192fb20-1aa2-7def-9abc-2233445566bb",
                "Name": {
                  "en-US": "Can Pere Antoni Beach",
                  "de-DE": "Strand Can Pere Antoni"
                },
                "Type": "beach",
                "Distance": 250,
                "Unit": "m"
              },
              {
                "ID": "0192fb20-1aa2-7def-9abc-4455667788dd",
                "Name": {
                  "en-US": "Palma Old Town",
                  "de-DE": "Altstadt von Palma"
                },
                "Type": "attraction",
                "Distance": 2.4,
                "Unit": "km",
                "IsArea": true
              },
              {
                "ID": "0192fb20-1aa2-7def-9abc-1122334455aa",
                "Name": {
                  "en-US": "Palma Cathedral",
                  "de-DE": "Kathedrale von Palma"
                },
                "Type": "landmark",
                "Distance": 3.2,
                "Unit": "km",
                "Latitude": 39.5675,
                "Longitude": 2.6484
              }
            ],
            "CheckIn": {
              "From": "15:00"
            },
            "CheckOut": {
              "Until": "11:00"
            },
            "GeneratedTexts": {
              "en-US": {
                "Summary": {
                  "Text": "Set on a quiet stretch of the Bay of Palma, Bahia Azul Beach Resort pairs direct beach access with bright, contemporary rooms and a sea-view rooftop pool.",
                  "Compliance": {
                    "AIGenerated": true
                  }
                },
                "HouseRules": {
                  "Text": "Check-in is from 15:00 and check-out is until 11:00. Pets are not permitted. Quiet hours apply between 23:00 and 08:00.",
                  "GeneratedAt": "2026-04-12T09:15:00Z",
                  "TextType": "rules",
                  "Compliance": {
                    "AIGenerated": true
                  }
                }
              },
              "de-DE": {
                "Summary": {
                  "Text": "Das Bahia Azul Strandresort liegt an einem ruhigen Abschnitt der Bucht von Palma und verbindet direkten Strandzugang mit hellen, modernen Zimmern und einem Dachpool mit Meerblick.",
                  "Compliance": {
                    "AIGenerated": true
                  }
                },
                "HouseRules": {
                  "Text": "Der Check-in ist ab 15:00 Uhr und der Check-out bis 11:00 Uhr moeglich. Haustiere sind nicht gestattet. Ruhezeiten gelten zwischen 23:00 und 08:00 Uhr.",
                  "GeneratedAt": "2026-04-12T09:15:00Z",
                  "TextType": "rules",
                  "Compliance": {
                    "AIGenerated": true
                  }
                }
              }
            },
            "GuestRating": {
              "ReviewScore": 93,
              "SubScores": {
                "Cleanliness": 96,
                "Facilities": 93,
                "Food": 91,
                "Location": 91,
                "Rooms": 95,
                "Service": 96,
                "Value": 90
              },
              "Texts": {
                "en-US": {
                  "Summary": "Guests consistently describe their stay as a peaceful, relaxing retreat highlighted by exceptionally friendly and attentive staff. Rooms and grounds are praised for being spotless and comfortable, while the delicious breakfast and calm adults-only setting make it an ideal getaway.",
                  "Pros": [
                    "Warm, attentive, and professional staff",
                    "Spotless rooms and well-kept grounds",
                    "Peaceful, child-free atmosphere",
                    "Superb and varied breakfast spread",
                    "Modern, spacious guest rooms"
                  ],
                  "Cons": [
                    "Extra charges for some premium drinks and minibar",
                    "Lunch and dinner buffets can feel repetitive to some"
                  ],
                  "GeneratedAt": "2026-11-05T18:10:57Z",
                  "Compliance": {
                    "AIGenerated": true
                  }
                }
              }
            },
            "RenderLayouts": {
              "Summary": "prose",
              "HouseRules": "highlights"
            },
            "Images": [
              {
                "ID": "0192fb20-1aa2-7def-9abc-1122334455aa",
                "URL": "https://cdn.ygo.ai/hotels/bahia-azul/exterior-pool.jpg",
                "Source": "photo",
                "Category": "exterior",
                "Features": [
                  "pool",
                  "sea_view"
                ],
                "Mood": [
                  "relaxing"
                ],
                "Tags": [
                  "rooftop",
                  "sunset"
                ],
                "AppealScore": 88,
                "QualityScore": 91,
                "AppealScoreVersion": "app-v4",
                "QualityScoreVersion": "qs-v4",
                "Width": 1600,
                "Height": 1067,
                "Format": "jpeg",
                "FileSize": 412000,
                "DominantColor": "#2E6F95",
                "BlurHash": "LKO2?U%2Tw=w]~RBVZRi};RPxuwH",
                "FileMetadata": {
                  "CaptureDate": "2012-06-14",
                  "Copyright": "© 2012 Hotel Sol S.A."
                },
                "Descriptions": {
                  "en-US": "Rooftop infinity pool overlooking the Bay of Palma at sunset."
                },
                "Compliance": {
                  "AIGenerated": true
                },
                "Presence": [
                  {
                    "Label": "person",
                    "Confidence": 0.91
                  },
                  {
                    "Label": "adult",
                    "Confidence": 0.86
                  }
                ],
                "Safety": {
                  "Inappropriate": 0.02,
                  "OffTopic": null
                },
                "TextDetections": [
                  {
                    "Content": "POOL BAR",
                    "Label": "signage",
                    "Confidence": 0.74
                  }
                ],
                "FeatureDetections": [
                  {
                    "Label": "pool",
                    "Confidence": 0.96
                  },
                  {
                    "Label": "sea_view",
                    "Confidence": 0.9
                  }
                ]
              }
            ],
            "Rooms": [
              {
                "ID": "0192fb30-2bb3-7abc-8def-99887766aabb",
                "Name": {
                  "en-US": "Double Room Sea View",
                  "de-DE": "Doppelzimmer mit Meerblick"
                },
                "SizeSqm": 26,
                "Beddings": [
                  [
                    {
                      "Type": "DOUBLE",
                      "Quantity": 1,
                      "Name": {
                        "en-US": "double bed",
                        "de-DE": "Doppelbett"
                      }
                    }
                  ],
                  [
                    {
                      "Type": "TWIN",
                      "Quantity": 2,
                      "Name": {
                        "en-US": "twin beds",
                        "de-DE": "Einzelbetten"
                      }
                    }
                  ]
                ],
                "FactualAttributes": [
                  {
                    "Key": "air_conditioning",
                    "Type": "factual",
                    "Name": {
                      "en-US": "Air Conditioning",
                      "de-DE": "Klimaanlage"
                    },
                    "Value": "true",
                    "ValueType": "boolean",
                    "ParentKey": "room_facilities",
                    "IsFree": true,
                    "GTCodes": [
                      "GT05-AICO",
                      "AT05-FRCH"
                    ]
                  }
                ],
                "GeneratedTexts": {
                  "en-US": {
                    "RoomDescription": {
                      "Text": "A bright 26 sqm room with a private balcony framing the bay, a king-size bed and a walk-in rain shower.",
                      "Compliance": {
                        "AIGenerated": true
                      }
                    }
                  }
                },
                "RenderLayouts": {
                  "": "roomcards"
                },
                "ExternalRoomIDs": {
                  "ProductRoomIDs": [
                    "11824",
                    "11902"
                  ]
                },
                "Images": [
                  {
                    "ID": "0192fb31-3cc4-7abc-8def-aabbccddeeff",
                    "URL": "https://cdn.ygo.ai/hotels/bahia-azul/room-seaview.jpg",
                    "Category": "room",
                    "Features": [
                      "balcony",
                      "sea_view"
                    ],
                    "Mood": [
                      "bright"
                    ],
                    "Tags": [
                      "king_bed"
                    ],
                    "AppealScore": 80,
                    "QualityScore": 84,
                    "AppealScoreVersion": "app-v4",
                    "QualityScoreVersion": "qs-v4",
                    "Width": 1500,
                    "Height": 1000,
                    "Format": "jpeg",
                    "FileSize": 356000,
                    "DominantColor": "#D9E2EC",
                    "BlurHash": "LEHV6nWB2yk8pyo0adR*.7kCMdnj",
                    "Descriptions": {
                      "en-US": "Sea-view double room with a private balcony."
                    },
                    "Compliance": {
                      "AIGenerated": true
                    }
                  }
                ],
                "Status": "active",
                "CreatedAt": "2026-03-01T08:00:00Z",
                "UpdatedAt": "2026-04-10T12:30:00Z"
              }
            ],
            "Tags": [
              {
                "ID": "0192fc01-1111-7abc-8def-aaaaaaaaaaaa",
                "Name": "Summer Campaign",
                "Description": "Hotels in the 2026 summer campaign"
              }
            ],
            "Status": "active",
            "TextStatus": "generated",
            "CreatedAt": "2026-03-01T08:00:00Z",
            "UpdatedAt": "2026-04-12T09:15:00Z"
          }
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "Project-scoped API key"
      },
      "deleteVisionImages_bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "User token (user_...) of an org admin or owner. Project-scoped API keys (proj_...) are refused with 403."
      }
    }
  }
}
