---
title: "List & Delete Monitors"
description: "List all active monitors for your workspace, or delete one by ID."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.kooperativa.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List & Delete Monitors

## List monitors

`GET /api/v1/monitors`

Returns all active monitors for the authenticated workspace.

```bash title="cURL"
curl "https://kooperativa.io/api/v1/monitors" \
  -H "Authorization: Bearer ik_live_..."
```

```json title="Response"
{
  "monitors": [
{
  "id": "45e0bba8-...",
  "type": "person",
  "subject_url": "https://www.linkedin.com/in/satyanadella",
  "label": "Satya Nadella",
  "webhook_url": "https://your-app.com/webhooks/kooperativa",
  "events": ["person.job_changed"],
  "active": true,
  "created_at": "2026-07-14T10:00:00Z"
}
  ]
}
```

:::note
The `webhook_secret` is never returned in list or get responses. It is only shown once at creation time in the dashboard.
:::

---

## Delete a monitor

`DELETE /api/v1/monitors`

Stop monitoring a profile or company and delete the monitor.

### Query parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| `id` | string | **Yes** | Monitor ID to delete |

```bash title="cURL"
curl -X DELETE "https://kooperativa.io/api/v1/monitors?id=45e0bba8-..." \
  -H "Authorization: Bearer ik_live_..."
```

```json title="Response"
{ "ok": true }
```

:::tip
If you want to temporarily pause notifications without losing the monitor configuration, contact support. A pause feature is on the roadmap.
:::

Source: https://docs.kooperativa.io/monitors/list-delete/index.mdx