API endpoints overview

Overview of all available API endpoints (the individual REST API URLs that are called). Base URL: https://epulz.io/api/v1

Authorization: send the header Authorization: Bearer epulzio_.... The request limit (rate limit) is 60 requests per minute per token. You generate a token in Settings -> API tokens.

Status / token check

• GET /status - verifies the token, returns e-mail, plan, monitor count and number of open incidents.

Monitors

• GET /monitors - list of all your monitors (including 24h uptime).
• GET /monitors/{id} - detail of a single monitor.
• POST /monitors - creates a new monitor. In the request body (JSON) send the fields name, type, target, interval_minutes, expected_status, expected_keyword.
• POST /monitors/bulk - bulk import (at most 200 monitors per request).
• PATCH /monitors/{id} - update an existing monitor (send only the fields you want to change).
• DELETE /monitors/{id} - deletes the monitor (along with check history and incidents).

Checks (history)

• GET /monitors/{id}/checks?limit=100 - the last N checks of a monitor (status, response time, HTTP status code, possible error, region). The limit parameter can be 1 to 500, default 50.

Incidents

• GET /incidents - list of incidents. Optional filters: monitor_id, resolved (true/false), limit (1-500, default 50).

Error codes

• 401 - missing or invalid token.
• 403 - monitor count limit of your plan exceeded (on create).
• 404 - monitor does not belong to you or does not exist.
• 429 - request limit exceeded (60 per minute per token).

Machine-readable documentation

The complete OpenAPI specification is available at /api/openapi.json. Interactive documentation where you can try endpoints directly (Swagger UI) is at /api/docs. Both require login or a valid token.