List tags

POST

/v2/project/content/listTags

Return the calling project's internal tags as a plain array under Data (not paginated). The request body is empty.

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/json

Examples

Responses

🟢200

application/json

Tags retrieved successfully.

Headers

Bodyapplication/json

🟠400listTags_BadRequest

🟠401listTags_Unauthorized

🟠403listTags_Forbidden

🟠429listTags_TooManyRequests

🔴500listTags_InternalServerError

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - A project with two tags

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

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

Save tag

Delete tag