AWorld APIs are in a pre-alpha stage and are being updated frequently. For integration inquiries or technical information, please contact us at server@aworld.org.

AWorld API

List tags

GET

https://api.eu-west-1.aworld.cloud/dashboard/v1/tags

Tags

Retrieves a paginated list of tags available in the workspace

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.eu-west-1.aworld.cloud/dashboard/v1/tags'

Response Example

{
    "items": [
        {
            "tagId": "string",
            "namespace": "string",
            "variant": "string",
            "origin": "CATALOG",
            "tagCatalogId": "string",
            "syncWithCatalog": true,
            "defaultLang": "string",
            "langs": [
                "string"
            ],
            "accountId": "string",
            "workspaceId": "string",
            "sourceRegion": "string",
            "stage": "DRAFT",
            "createdAt": "2019-08-24T14:15:22Z",
            "updatedAt": "2019-08-24T14:15:22Z"
        }
    ],
    "nextToken": "string"
}

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Query Params

nextToken

string

optional

Pagination token for fetching the next set of results

limit

integer

optional

Maximum number of tags to return per page

Default:

Responses

🟢200OK

application/json

List of tags retrieved successfully

Body

items

array[object (Tag) {14}]

optional

tagId

string

required

Unique identifier for the tag

namespace

string

required

Namespace that groups related tags together

variant

string

required

Variant identifier within the namespace

origin

enum<string>

required

Whether the tag comes from a central catalog or is custom-created

Allowed values:

CATALOGCUSTOM

tagCatalogId

string

optional

ID reference to the original tag in the catalog if applicable

syncWithCatalog

boolean

optional

Whether the tag should be synced with catalog updates

defaultLang

string

required

The default language code for the tag content

langs

array[string]

required

List of language codes available for this tag

accountId

string

optional

The account ID that owns this tag

workspaceId

string

optional

The workspace ID that contains this tag

sourceRegion

string

optional

AWS region where the tag was created

stage

enum<string>

optional

Current publication stage of the tag

Allowed values:

DRAFTPUBLISHED

createdAt

string <date-time>

required

Timestamp when the tag was created

updatedAt

string <date-time>

required

Timestamp when the tag was last updated

nextToken

string

optional

Pagination token for the next set of results

🟠401Unauthorized

Modified at 2025-06-26 12:50:38

Publish a reward rule

Create tag