Delete a monitor

Deprecated

DELETE

/monitors/{monitor_id}

const url = 'https://api.perstat.io/monitors/example';
const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request DELETE \
  --url https://api.perstat.io/monitors/example \
  --header 'Authorization: Bearer <token>'

Permanently removes a monitor together with its incidents, check history, availability figures, and exclusion windows. To retire a service and keep that record, archive the monitor instead with POST /monitors/{monitor_id}/archive: its checks stop and its plan slot is freed.

Deprecated for API keys: Deleting a monitor with an API key is deprecated since 2026-10-02. Until 2027-01-01 the call works as before, and its 204 answer to an API key carries Deprecation: @1790899200, Sunset: Fri, 01 Jan 2027 00:00:00 GMT, a Link to the announcement (rel="deprecation"), and a Link to the archive route (rel="successor-version"). From 2027-01-01, API keys receive 403; permanent deletion then needs a signed-in session in the Perstat app.

Before you delete: This action cannot be undone. To stop checks temporarily, update the monitor with enabled: false instead.

Permissions: Requires a project management role in the owning organization. The deletion is recorded in the activity log.

Success: Returns 204 No Content with an empty response body. Do not attempt to parse it as JSON. Until its sunset, accepts API keys with the monitors:write scope, subject to current role and resource grants.

Authorizations

bearer

Parameters

Path Parameters

monitor_id

required

string

Responses

204

Monitor deleted. The response has no body. The answer to an API key carries the deprecation headers.

401

Authentication is missing or invalid.

403

The authenticated caller does not have permission to delete this monitor. From 2027-01-01, API keys always receive this status.

404

No accessible monitor matches the supplied monitor ID.