Delete Tag

DELETE

https://platform-api.convirza.com/v3/tag

Miscellaneous

Last modified:2026-04-03 14:27:57

Soft-deletes one or more call tags by marking them as inactive. Deleted tags no longer appear in tag selectors or lists.

Single vs. bulk deletion
The request body accepts either a single tag ID or an array of tag IDs for bulk deletion.

Effect on existing call records
Deleting a tag does not remove it from historical call records — calls that were already tagged retain their tag history for reporting. The tag simply becomes unavailable for future use.

Reversibility
Soft deletion can be reversed by platform administrators. Contact support to restore a deleted tag.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Tags deleted successfully

Body

🟠400

🟠401

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --request DELETE 'https://platform-api.convirza.com/v3/tag' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "tag": {
        "id": [
            123,
            456,
            789
        ]
    }
}'

Response Example

200 - Example 1

{
    "code": 200,
    "message": "Resource deleted successfully",
    "data": null,
    "request_id": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2026-03-29T12:00:00.000Z"
}

Modified at 2026-04-03 14:27:57

Update Tag