API V1 / Tags / Create

Create a tag. Do not send guid; the server assigns one. Tag names must be unique per account.

Endpoint

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

Request

Fields

`name` req	String, max 255 characters. Must be unique per account.
`color_hex` opt	Hex color like `#336699`. Defaults to `#999999` when omitted or empty.

{ "name": "critical" }

Response

Top level

`ok`	Always `true` on success.
`tag`	Tag object. 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

`guid`	Tag id.
`name`	Tag name.
`color_hex`	Hex color like `#336699`.
`monitor_count`	Monitors with this tag.
`heartbeat_count`	Heartbeats with this tag.

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": { "guid": "6ba7b810-9dad-11d1-80b4-00c04fd430c8", "name": "critical", "color_hex": "#999999", "monitor_count": 0, "heartbeat_count": 0 }, "capacity": { "limit": 20, "used": 5, "remaining": 15 }, "rate_limit": { "tier": 1, "cost": 1, "timeframe": "minute", "limit": 60, "used": 12, "remaining": 48 } }