Update Tag

PUT

/v1/tags/service-account/{id}

Updates an existing tag. All fields are optional – only provided fields are updated.

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://your-auth-server/connect/token

Scopes:

VoxaAPI-Access Voxa API as a service account

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Tag updated successfully

Bodyapplication/json

🟠401

🟠403

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT 'https://api.voxa.sa/v1/tags/service-account/' \
--header 'Content-Type: application/json' \
--data '{
    "Name": "VIP Updated",
    "Icon": "crown",
    "Description": "Updated VIP tag",
    "IsPinned": false
}'

Response Example

{
    "Id": "38a5a5bb-dc30-49a2-b175-1de0d1488c43",
    "Name": "string",
    "Icon": "string",
    "IsPinned": true,
    "CreationTime": "2019-08-24T14:15:22.123Z"
}

Modified at 2026-02-22 19:22:10

Delete Tag

List Tags