API
API: errors and rate limits
Error format, status codes, error codes and request limits.
Error format
{
"error": {
"code": "plan_limit",
"message": "Interval 30s requires the Pro plan. Minimum on Starter is 60s.",
"field": "intervalSec"
}
}Status codes
| Status | Meaning |
|---|---|
| 400 | Malformed JSON or query |
| 401 | Missing or invalid API key |
| 403 | Key lacks the scope, or the resource belongs to another workspace |
| 404 | Not found |
| 409 | Conflict (duplicate idempotency key with a different body) |
| 422 | Validation failed; see field |
| 429 | Rate limited; see Retry-After |
| 5xx | Our fault; retry with backoff |
Error codes
validation, plan_limit, not_found, forbidden_scope, rate_limited, conflict, internal.
Rate limits
- 600 requests per minute per API key for reads
- 120 requests per minute per key for writes
POST /monitors/{id}/check: 1 per monitor per 10 seconds
Headers on every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.