Delete a monitor API
Delete a monitor: DELETE /v1/monitors/{monitor_id}. Free per request.
DELETE /v1/monitors/{monitor_id}
DELETE /v1/monitors/{monitor_id}
Delete a monitor.
- Cost: Free
- Cache: Not cached.
Parameters#
| Name | Type | Required | Description | In |
|---|---|---|---|---|
monitor_id | string | yes | Monitor id. | path |
Example request#
Set your key in the environment first (see Authentication).
1curl -X DELETE "https://api.socialscrape.dev/v1/monitors/mon_0123456789abcdef" \2 -H "x-api-key: $SOCIALSCRAPE_API_KEY"1import os2import requests34res = requests.delete(5 "https://api.socialscrape.dev/v1/monitors/mon_0123456789abcdef",6 headers={"x-api-key": os.environ["SOCIALSCRAPE_API_KEY"]},7)8body = res.json()910if body["ok"]:11 print(body["data"])12else:13 print(body["error"]["code"], body["error"]["message"])1const res = await fetch("https://api.socialscrape.dev/v1/monitors/mon_0123456789abcdef", {2 method: "DELETE",3 headers: { "x-api-key": process.env.SOCIALSCRAPE_API_KEY! },4});5const body = await res.json();67if (body.ok) {8 console.log(body.data);9} else {10 console.error(body.error.code, body.error.message);11}Example response#
This is a sample with illustrative values. Status 200.
200 OKSample response
1{2 "ok": true,3 "credits_charged": 0,4 "credits_remaining": 5000,5 "cached": false,6 "cached_at": null,7 "request_id": "req_56b5fd791543e639a6c65127",8 "data": {9 "object": "monitor",10 "id": "mon_0123456789abcdef",11 "endpoint": "/v1/github/user/repositories",12 "params": {13 "handle": "torvalds"14 },15 "interval_minutes": 60,16 "webhook_url": "https://example.com/hook",17 "active": false,18 "created_at": "2026-10-29T14:00:00Z",19 "webhook_secret": null,20 "last_run_at": "2026-10-29T15:00:00Z",21 "next_run_at": null,22 "last_error": null23 },24 "cursor": null,25 "has_more": null26}Response#
A Monitor object in data.
See Data models for every field. The envelope around data is described in Responses.
Errors#
Failures are free: credits_charged is 0. Branch on error.code, never on the message.
| Code | HTTP | Retry | Meaning |
|---|---|---|---|
invalid_params | 400 | no | A parameter is missing, unknown or has the wrong type. |
Every request can also fail with the account and platform errors listed on the Errors page.
Related endpoints#
- Create a monitor (
POST /v1/monitors) - List monitors (
GET /v1/monitors) - Send a test event (
POST /v1/monitors/{monitor_id}/test) - Webhook delivery log (
GET /v1/monitors/{monitor_id}/deliveries) - Send an event again (
POST /v1/monitors/events/{event_id}/redeliver) - Monitor events (
GET /v1/monitors/events)