Generate text

POST

/v2/project/content/generateText

Queue an asynchronous text-generation run for a selection of the project's hotels and return the created run object.

The 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.

Hotels 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.

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

Text-generation run queued successfully. The run is processed asynchronously; poll getTextGenerationStatus with the returned run ID.

Headers

Bodyapplication/json

🟠400generateText_BadRequest

🟠401generateText_Unauthorized

🟠403generateText_Forbidden

🟠404generateText_NotFound

🟠409generateText_Conflict

🟠429generateText_TooManyRequests

🔴500generateText_InternalServerError

Request Example

Shell

JavaScript

Java

Swift

cURL

Regenerate all active templates for two hotels in all template localesRegenerate only the Summary template, two locales, full regenerationFill missing texts for every project hotel carrying a tag

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

Response Example

200 - A freshly queued run for two hotels

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

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

Content Enrichment API

Get text generation status