Groups / Update

Update an existing group. Send the full payload, including guid and all fields.

Endpoint

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

Request

Key fields

guid key Group id.

Fields

name req String, max 255 characters.
color_hex req Hex color like #336699.
{ "guid": "550e8400-e29b-41d4-a716-446655440000", "name": "Production (renamed)", "color_hex": "#993366" }

Response

Top level

ok Always true on success.
group Group object. 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

guid Group id.
name Group name.
color_hex Hex color like #336699, or null when unset.
monitor_count Monitors in this group.
heartbeat_count Heartbeats in this group.

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": { "guid": "550e8400-e29b-41d4-a716-446655440000", "name": "Production (renamed)", "color_hex": "#993366", "monitor_count": 4, "heartbeat_count": 1 }, "capacity": { "limit": 10, "used": 2, "remaining": 8 }, "rate_limit": { "tier": 1, "cost": 1, "timeframe": "minute", "limit": 60, "used": 12, "remaining": 48 } }