Remove tag from hotels (bulk)

POST

/v2/project/content/removeTagFromHotels

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.

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 remove processed. Each hotel id carries its own outcome.

Headers

Bodyapplication/json

🟠400removeTagFromHotels_BadRequest

🟠401removeTagFromHotels_Unauthorized

🟠403removeTagFromHotels_Forbidden

🟠404removeTagFromHotels_NotFound

🟠429removeTagFromHotels_TooManyRequests

🔴500removeTagFromHotels_InternalServerError

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.ygo.ai/v2/project/content/removeTagFromHotels' \
--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 batch with one removed and one invalid id

{
    "Data": {
        "TagID": "0192fc01-1111-7abc-8def-aaaaaaaaaaaa",
        "Results": [
            {
                "HotelID": "0192fb17-5dc6-7abc-8def-123456789abc",
                "Status": "removed"
            },
            {
                "HotelID": "not-a-uuid",
                "Status": "invalid"
            }
        ]
    }
}

Modified at 2026-07-29 08:24:52

Add tag to hotels (bulk)

Delete hotel image pin