List Tags

GET

/v1/tags/service-account

Returns a paginated list of all tags created in your workspace.

Notes:

There are currently no filtering options on this endpoint (e.g. by name or pinned status) — only pagination and sorting.

As with all tag responses, description is not included in the returned objects even if one was set.

Request

Authorization

OAuth 2.0

Client Credentials

Add the parameter

Authorization

to Headers，whose value is to concatenate the Token after the Bearer.

Example:

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

Token URL: https://api.voxa.sa/connect/token

Scopes:

VoxaAPI-Access Voxa API as a service account

Query Params

Responses

🟢200OK

application/json

Paged list of tags.

Bodyapplication/json

🟠401Unauthorized

🟠403Forbidden

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.voxa.sa/v1/tags/service-account?skipCount=undefined&maxResultCount=undefined&sorting=undefined'

Response Example

{
    "totalCount": 2,
    "items": [
        {
            "id": "3a1ebef0-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
            "name": "VIP",
            "icon": "⭐",
            "isPinned": true,
            "creationTime": "2026-06-22T10:00:00Z"
        },
        {
            "id": "4b2fcef1-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
            "name": "Follow-up",
            "icon": null,
            "isPinned": false,
            "creationTime": "2026-06-20T08:30:00Z"
        }
    ]
}

Modified at 2026-06-22 16:07:56

Update Tag

Call Webhook