Get text generation status

POST

/v2/project/content/getTextGenerationStatus

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.

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 status retrieved successfully.

Headers

Bodyapplication/json

🟠400getTextGenerationStatus_BadRequest

🟠401getTextGenerationStatus_Unauthorized

🟠403getTextGenerationStatus_Forbidden

🟠404getTextGenerationStatus_NotFound

🟠429getTextGenerationStatus_TooManyRequests

🔴500getTextGenerationStatus_InternalServerError

Request Example

Shell

JavaScript

Java

Swift

cURL

Poll a run by its UUID (still in progress)Poll a run by its UUID (finished)Poll a run by its UUID (failed)

curl --location 'https://api.ygo.ai/v2/project/content/getTextGenerationStatus' \
--header 'X-Project-ID: ' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "RunID": "0192fb50-8bb2-7abc-8def-112233445566"
}'

Response Example

200 - A run still in progress

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

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

Generate text

Preview text