Groups / Delete

Delete a group by guid. Monitor and heartbeat assignments to this group are removed.

Endpoint

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

Request

Key fields

guid key Group id.
{ "guid": "550e8400-e29b-41d4-a716-446655440000" }

Response

Top level

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

group

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

capacity

limit Maximum groups allowed on your plan.
used Groups currently in use.
remaining Groups 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, "group": { "deleted": true, "guid": "550e8400-e29b-41d4-a716-446655440000" }, "capacity": { "limit": 10, "used": 1, "remaining": 9 }, "rate_limit": { "tier": 1, "cost": 1, "timeframe": "minute", "limit": 60, "used": 12, "remaining": 48 } }