Skip to main content
DELETE
Delete a monitor
Delete a monitor and all its results. The response is the monitor as it was. A deleted monitor can’t be restored, so to stop one for a while, pause it instead.

When to use it

Delete a monitor when you no longer need its topic or its results. Its results go with it, so read its results first if you want to keep them. If the webhook lists monitor.deleted, your endpoint gets that event. If the API returns 409 with request_rejected, the monitor can’t be deleted on its own. message says why.

SDK, CLI and MCP

The SDK methods need SDK 0.2.0 or later. See SDKs → Monitors, CLI → Monitors and Monitors tools.

Authorizations

X-API-Key
string
header
required

Your API key, such as keen_.... Create one in the Keenable console. If you send both this header and Authorization, the API uses this one.

Path Parameters

id
string
required

The monitor's ID, such as mon_3kq9z2c8f1a04b7d9e6f5a21.

Response

The monitor as it was before deletion

id
string
required
Example:

"mon_3kq9z2c8f1a04b7d9e6f5a21"

object
enum<string>
required
Available options:
monitor
name
string | null
required
Example:

"Open-weights LLM releases"

status
enum<string>
required

active and paused are set by you. completed: a once monitor after its run. disabled: set by Keenable after 10 failed runs in a row, or when no webhook delivery succeeded for 3 days. Only an active monitor matches pages.

Available options:
active,
paused,
disabled,
completed
schedule
object | null
required

All three keys are always present. timezone is UTC for a cron schedule sent without one, and null for interval and once.

webhook
object | null
required
metadata
object | null
required
last_run_at
string<date-time> | null
required

When the last run ended.

next_run_at
string<date-time> | null
required

The next scheduled run. null without a schedule or while the monitor isn't active.

upcoming_runs
string<date-time>[]
required

The next three run times, in UTC. Empty without a schedule or while the monitor isn't active.

created_at
string<date-time>
required
updated_at
string<date-time>
required
output_schema
object | null