Delete Tag

DELETE

/v1/tags/service-account/id

Deletes a tag from your workspace. The tag will no longer appear in any list and can no longer be applied to new contacts or conversations.

Notes:

If the tag ID doesn't exist, or belongs to a different workspace, you'll get a "not found" error.

Deletion here removes the tag from the workspace's active list, but historical references to it (e.g. on past conversation timeline records) are not affected.

Tag deletes successfully with no response body ( no need to worry ).

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

Responses

🟢204No Content

Tag deleted successfully. No response body.

This response does not have a body.

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE 'https://api.voxa.sa/v1/tags/service-account/id'

Modified at 2026-06-22 16:11:08

Create Tag

Update Tag