Save tag

POST

/v2/project/content/saveTag

Upsert a project tag. Omit TagID to create a new tag or supply an existing TagID to rename it. The name must be unique within the project (case-insensitive); a duplicate returns 409, and renaming a tag id not in the 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

Tag created or renamed successfully.

Headers

Bodyapplication/json

🟠400saveTag_BadRequest

🟠401saveTag_Unauthorized

🟠403saveTag_Forbidden

🟠404saveTag_NotFound

🟠409saveTag_Conflict

🟠429saveTag_TooManyRequests

🔴500saveTag_InternalServerError

Request Example

Shell

JavaScript

Java

Swift

cURL

Create a new tag (no TagID)Rename an existing tag (TagID + new Name)

curl --location 'https://api.ygo.ai/v2/project/content/saveTag' \
--header 'X-Project-ID: ' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "Name": "Summer Campaign"
}'

Response Example

200 - A newly created tag

{
    "Data": {
        "ID": "0192fc01-1111-7abc-8def-aaaaaaaaaaaa",
        "ProjectID": "0192fa00-0000-7abc-8def-000000000000",
        "Name": "Summer Campaign",
        "CreatedBy": "editor@example.com"
    }
}

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

List text templates

List tags