Delete an uptime monitor

DELETE

/uptime/monitors/{id}

curl --request DELETE \
  --url 'https://api.nsin.ir/uptime/monitors/1?domain=example.com' \
  --header 'Authorization: Bearer <token>'

• Production

Requires domain.settings. The monitor’s open incident is resolved without a recovery notification; its resolved incident history is kept, because it is the record behind alerts you may still be reading.

Authorizations

• bearerAuth
• apiKeyAuth

Parameters

Path Parameters

id

required

integer

Query Parameters

domain

required

string

The domain name (for example example.com). These endpoints take the domain as a query parameter rather than a path segment.

Example

example.com

Responses

200

Deleted.

Media type application/json

object

deleted

boolean

Example ^generated

{
  "deleted": true
}

400

Invalid monitor id.

Media type application/json

The single error shape used by every endpoint.

object

error

required

Human-readable description of what went wrong.

string

Example

{
  "error": "read-only API key"
}

401

Missing, malformed, revoked or expired API key — or the owning account is inactive.

Media type application/json

The single error shape used by every endpoint.

object

error

required

Human-readable description of what went wrong.

string

Examples

Example invalidKey

{
  "error": "invalid API key"
}

403

The key is read-only, your role on the domain lacks the required permission, or the domain’s plan does not include the feature.

Media type application/json

The single error shape used by every endpoint.

object

error

required

Human-readable description of what went wrong.

string

Example

{
  "error": "read-only API key"
}

404

No such monitor on this domain. A monitor id belonging to another domain is reported the same way, so an id can never be used to probe another tenant.

Media type application/json

The single error shape used by every endpoint.

object

error

required

Human-readable description of what went wrong.

string

Examples

Example notFound

{
  "error": "monitor not found"
}

429

The key exceeded its request budget (300 requests per minute by default).

Media type application/json

The single error shape used by every endpoint.

object

error

required

Human-readable description of what went wrong.

string

Examples

Example limited

{
  "error": "rate limit exceeded"
}