# Social Fetch API - Monitors endpoints
# Base URL: https://api.socialfetch.dev
# Auth: x-api-key header (sfk_...)
# Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json
# Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json

18 documented Monitors operations. Do not invent paths - only the routes below (and their linked markdown pages) are supported.

## GET /v1/monitors/sources
List watchable sources
Credit cost: 0 credits per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/monitors/sources/get.mdx
curl "https://api.socialfetch.dev/v1/monitors/sources" \
  -H "x-api-key: YOUR_API_KEY"

## POST /v1/monitors
Create a monitor
Credit cost: 0 credits per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/monitors/post.mdx
Parameters:
- dryRun (optional, boolean) - When true, validates the monitor and returns a cost preview without creating anything or running the baseline check.
curl "https://api.socialfetch.dev/v1/monitors" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"string","operationId":"string","params":{},"schedule":null,"webhookEndpointId":"string","webhook":{"url":"string"},"spendCapCredits":0}' \
  -X POST

## GET /v1/monitors
List monitors
Credit cost: 0 credits per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/monitors/get.mdx
Parameters:
- status (optional, string, enum: active | paused | exhausted | broken) - Optional filter to only return monitors in this status.
curl "https://api.socialfetch.dev/v1/monitors" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/monitors/{id}
Get a monitor
Credit cost: 0 credits per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/monitors/id/get.mdx
Parameters:
- id (required, string) - Monitor identifier.
curl "https://api.socialfetch.dev/v1/monitors/abc123" \
  -H "x-api-key: YOUR_API_KEY"

## PATCH /v1/monitors/{id}
Update a monitor
Credit cost: 0 credits per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/monitors/id/patch.mdx
Parameters:
- id (required, string) - Monitor identifier.
curl "https://api.socialfetch.dev/v1/monitors/abc123" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"string","schedule":null,"webhookEndpointId":"string","spendCapCredits":0,"status":"active"}' \
  -X PATCH

## DELETE /v1/monitors/{id}
Delete a monitor
Credit cost: 0 credits per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/monitors/id/delete.mdx
Parameters:
- id (required, string) - Monitor identifier.
curl "https://api.socialfetch.dev/v1/monitors/abc123" \
  -H "x-api-key: YOUR_API_KEY" \
  -X DELETE

## POST /v1/monitors/{id}/trigger
Manually trigger a monitor poll
Credit cost: 0 credits per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/monitors/id/trigger/post.mdx
Parameters:
- id (required, string) - Monitor identifier.
curl "https://api.socialfetch.dev/v1/monitors/abc123/trigger" \
  -H "x-api-key: YOUR_API_KEY" \
  -X POST

## GET /v1/monitors/{id}/events
List monitor events
Credit cost: 0 credits per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/monitors/id/events/get.mdx
Parameters:
- id (required, string) - Monitor identifier.
- cursor (optional, string) - Opaque pagination cursor from a previous response's `nextCursor`.
- limit (optional, integer) - Maximum number of events to return. Defaults to 25 server-side.
Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false.
curl "https://api.socialfetch.dev/v1/monitors/abc123/events" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/monitors/{id}/checks
List a monitor's recent check history
Credit cost: 0 credits per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/monitors/id/checks/get.mdx
Parameters:
- id (required, string) - Monitor identifier.
curl "https://api.socialfetch.dev/v1/monitors/abc123/checks" \
  -H "x-api-key: YOUR_API_KEY"

## POST /v1/webhook-endpoints
Create a webhook endpoint
Credit cost: 0 credits per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/webhook-endpoints/post.mdx
curl "https://api.socialfetch.dev/v1/webhook-endpoints" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"http","url":"string","description":"string"}' \
  -X POST

## GET /v1/webhook-endpoints
List webhook endpoints
Credit cost: 0 credits per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/webhook-endpoints/get.mdx
curl "https://api.socialfetch.dev/v1/webhook-endpoints" \
  -H "x-api-key: YOUR_API_KEY"

## GET /v1/webhook-endpoints/{id}
Get a webhook endpoint
Credit cost: 0 credits per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/webhook-endpoints/id/get.mdx
Parameters:
- id (required, string) - Webhook endpoint identifier.
curl "https://api.socialfetch.dev/v1/webhook-endpoints/abc123" \
  -H "x-api-key: YOUR_API_KEY"

## PATCH /v1/webhook-endpoints/{id}
Update a webhook endpoint
Credit cost: 0 credits per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/webhook-endpoints/id/patch.mdx
Parameters:
- id (required, string) - Webhook endpoint identifier.
curl "https://api.socialfetch.dev/v1/webhook-endpoints/abc123" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"description":"string","status":"active"}' \
  -X PATCH

## DELETE /v1/webhook-endpoints/{id}
Delete a webhook endpoint
Credit cost: 0 credits per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/webhook-endpoints/id/delete.mdx
Parameters:
- id (required, string) - Webhook endpoint identifier.
curl "https://api.socialfetch.dev/v1/webhook-endpoints/abc123" \
  -H "x-api-key: YOUR_API_KEY" \
  -X DELETE

## POST /v1/webhook-endpoints/{id}/test
Send a test webhook event
Credit cost: 0 credits per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/webhook-endpoints/id/test/post.mdx
Parameters:
- id (required, string) - Webhook endpoint id.
curl "https://api.socialfetch.dev/v1/webhook-endpoints/abc123/test" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"sampleType":"string"}' \
  -X POST

## POST /v1/webhook-endpoints/{id}/rotate-secret
Rotate a webhook endpoint secret
Credit cost: 0 credits per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/webhook-endpoints/id/rotate-secret/post.mdx
Parameters:
- id (required, string) - Webhook endpoint id.
curl "https://api.socialfetch.dev/v1/webhook-endpoints/abc123/rotate-secret" \
  -H "x-api-key: YOUR_API_KEY" \
  -X POST

## GET /v1/webhook-endpoints/{id}/deliveries
List deliveries for a webhook endpoint
Credit cost: 0 credits per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/webhook-endpoints/id/deliveries/get.mdx
Parameters:
- id (required, string) - Webhook endpoint id.
- status (optional, string, enum: pending | success | failed) - Optional filter for delivery status.
- after (optional, string) - ISO-8601 cursor (an earlier delivery's `createdAt`). When set, returns only strictly newer deliveries, oldest-first, for tailing — e.g. `socialfetch listen`. Omit for the usual newest-first page.
curl "https://api.socialfetch.dev/v1/webhook-endpoints/abc123/deliveries" \
  -H "x-api-key: YOUR_API_KEY"

## POST /v1/webhook-deliveries/{id}/redeliver
Manually redeliver a webhook delivery
Credit cost: 0 credits per successful request.
Docs: https://www.socialfetch.dev/docs/api/v1/webhook-deliveries/id/redeliver/post.mdx
Parameters:
- id (required, string) - Webhook delivery id to redeliver.
curl "https://api.socialfetch.dev/v1/webhook-deliveries/abc123/redeliver" \
  -H "x-api-key: YOUR_API_KEY" \
  -X POST