AI agents for Healthchecks.io

List checks

Lists the project's checks, optionally only those with all the given tags or one slug.

Get a check

Reads one check by its UUID (or its unique_key with a read-only key): status, last_ping, next_ping, n_pings, its schedule or period, grace, tags, desc, its integrations (channels) and ping_url.

List a check's pings

Lists the pings a check received, newest first (up to 100 on free plans, 1,000 on paid).

List a check's status changes

Lists when a check went down and came back up ("flips"), newest first, within the last seconds or between two Unix times, as result: each with its timestamp and up (1 up, 0 down).

List integrations

Lists the project's integrations (where alerts go), as channels: each with its id, name and kind (email, slack, sms, webhook …).

Create a check

Creates a check and returns it with its uuid and ping_url (the job calls that address when it runs).

Update a check

Changes a check's name, slug, tags, description, period or schedule, time zone, grace time or integrations; fields left out keep their values.

Pause a check

Stops monitoring a check without deleting it (status paused), for planned downtime.

Resume a check

Resumes monitoring of a paused check (status new until its next ping).

Delete a checkDeletes data

Deletes a check for good, with its ping history; pings to its address stop being recorded.