API keys and the API

Create and read monitors, incidents and maintenance from your own scripts.

Last reviewed November 11, 2026

  1. Open Settings, API keys (owners and admins) and create a key. A read key can call every GET. A write key can also make changes.
  2. Send it as a bearer token.
List your monitors
export KEY=your_api_key
curl -H "Authorization: Bearer $KEY" https://app.uptimewave.com/api/v1/monitors
Create a monitor
curl -X POST https://app.uptimewave.com/api/v1/monitors \
  -H "Authorization: Bearer $KEY" -H "Content-Type: application/json" \
  -d '{"type":"http","target":"example.com","name":"Website","interval_seconds":60}'
  • You can manage monitors, read incidents, and schedule maintenance.
  • Limit: 120 requests per minute per key. Every response shows your remaining allowance, and going over returns 429 with a Retry-After header.
  • Errors are JSON: {"error": "What happened.", "code": "invalid"}.

Related