Skip to main content

Tag API - Delete

Written by Marcus Warren

Use this endpoint to delete a tag from your account.


Endpoint

DELETE https://e1.envoke.com/v2/tags/{ID}

Replace {ID} with the Envoke tag ID you want to delete. Authentication is via HTTP Basic Auth using your API ID and API Key.


Important

Deletion is permanent. Deleting a tag removes the tag record and all contact-to-tag associations. Contacts assigned to the deleted tag are not deleted β€” they remain in your account and simply lose their assignment to this tag. The deletion cannot be undone via the API.


Response

On success:

{   "success": true,   "result_text": "Deleted",   "result_data": [] }

If the tag ID is not found:

{   "success": false,   "result_text": "Validation failed, see 'result_data' -> 'errors'",   "result_data": {     "errors": ["Item with id '999999' not found"]   } }

Example

curl -X DELETE -gs \   -u "$API_ID:$API_KEY" \   "https://e1.envoke.com/v2/tags/42"

Replace 42 with the ID of the tag you want to delete, and substitute your actual API ID and API Key.


Note: The curl examples above are formatted for readability. All requests must use properly encoded URLs.

For code examples and interactive testing, visit api.envoke.com.

Did this answer your question?