Preview text

POST

/v2/project/content/previewText

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.

Hotels are selected by HotelIDs and/or TagIDs (combined and deduplicated, capped at 100), and every selected hotel must belong to the calling project.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Preview computed successfully.

Headers

Bodyapplication/json

🟠400previewText_BadRequest

🟠401previewText_Unauthorized

🟠403previewText_Forbidden

🟠404previewText_NotFound

🟠429previewText_TooManyRequests

🔴500previewText_InternalServerError

Request Example

Shell

JavaScript

Java

Swift

cURL

Preview all active templates for one hotelPreview a single template in two localesPreview every project hotel carrying a tag

curl --location 'https://api.ygo.ai/v2/project/content/previewText' \
--header 'X-Project-ID: ' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "HotelIDs": [
        "0192fb17-5dc6-7abc-8def-123456789abc"
    ]
}'

Response Example

200 - A hotel with one missing and one stale text

{
    "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
    }
}

Modified at 2026-07-01 06:49:44

Get text generation status

Get enriched hotel