Add tag to hotels (bulk)

POST

/v2/project/content/addTagToHotels

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.

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

Bulk add processed. Each hotel id carries its own outcome.

Headers

Bodyapplication/json

🟠400addTagToHotels_BadRequest

🟠401addTagToHotels_Unauthorized

🟠403addTagToHotels_Forbidden

🟠404addTagToHotels_NotFound

🟠429addTagToHotels_TooManyRequests

🔴500addTagToHotels_InternalServerError

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - A mixed batch: one applied, one skipped, one invalid

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

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

Delete tag

Remove tag from hotels (bulk)