Skip to content
EnvokeEnvokeEnvoke Developers

Tag API - Delete

View as MarkdownOpenAPI

Use this endpoint to delete a tag from your account.

Endpoint

Section titled “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

Section titled “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

Section titled “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

Section titled “Example”
Terminal window
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.

Full reference, OpenAPI description, and Postman collection: developers.envoke.com.