Tags / Delete

Delete a tag by guid. Monitor and heartbeat tag assignments are removed.

Endpoint

Method POST
Url https://downdar.com/api/v1/tags/delete

Request

Key fields

guid key Tag id.
{ "guid": "6ba7b810-9dad-11d1-80b4-00c04fd430c8" }

Response

Top level

ok Always true on success.
tag Deleted tag reference. Fields below apply to tag.
capacity Tag quota for the account.
rate_limit Rate limit state for the tier this endpoint consumes. Present on every successful response.

tag

deleted Always true when the tag was removed.
guid Deleted tag id.

capacity

limit Maximum tags allowed on your plan.
used Tags currently in use.
remaining Tags you can still create.

rate_limit

tier Rate tier this endpoint counts against (1-5).
cost Units consumed by this request against the tier window.
timeframe Rolling limit window: second, minute, hour, or day.
limit Maximum units allowed in the timeframe for this tier on your plan.
used Units already used in the current window.
remaining Units left before this tier returns HTTP 429.
{ "ok": true, "tag": { "deleted": true, "guid": "6ba7b810-9dad-11d1-80b4-00c04fd430c8" }, "capacity": { "limit": 20, "used": 4, "remaining": 16 }, "rate_limit": { "tier": 1, "cost": 1, "timeframe": "minute", "limit": 60, "used": 12, "remaining": 48 } }