Skip to content
Docs

Delete Warmup Tag

Delete a warmup pool tag.

DELETE/api/v1/warmup/tags/{tag_id}

Requires an API key with the write scope.

Warmup tags group accounts in the warmup pool. They do not change sending. Deleting a tag takes it off every account that carried it; the accounts are untouched.

Path Parameters#

tag_idstringpathrequired
The tag id.

Response#

dataobject
Show data
idstring
The deleted tag id.
deletedboolean
Always true.

Errors#

StatusDescription
401Missing, invalid, revoked or expired API key
403API key does not have the required scope: write
404Tag not found: the tag does not exist in this workspace

Rate Limit#

  • 120 requests per minute, shared by every write call in your workspace. Fixed 60-second window.
  • Every response includes X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset (unix epoch seconds) and X-RateLimit-Bucket (write).
  • A 429 response includes a Retry-After header (seconds until the bucket resets).

For client-side patterns, see Rate Limiting.

Was this page helpful?
View as MarkdownLast updated November 4, 2026