---
title: "Run a monitor"
method: POST
path: "/monitor/{monitorId}/run"
tags: ["Monitoring"]
---

# Run a monitor

`POST /monitor/{monitorId}/run`

## Path parameters

- `monitorId` string, uuid, required

## Response `200`

Monitor check queued

- MonitorRunResponse
  - `success` boolean
  - `id` string, uuid
  - `data` MonitorCheck
    - `id` string, uuid
    - `monitorId` string, uuid
    - `status` 'queued' | 'running' | 'completed' | 'failed' | 'partial' | 'skipped_overlap'
    - `trigger` 'scheduled' | 'manual'
    - `scheduledFor` string, date-time, nullable
    - `startedAt` string, date-time, nullable
    - `finishedAt` string, date-time, nullable
    - `estimatedCredits` integer, nullable — Upper-bound credits reserved for this check before Firecrawl knows how many pages changed and require judging.
    - `reservedCredits` integer, nullable
    - `actualCredits` integer, nullable — Final credits charged for this check after scrapes, crawls, and any changed-page judge calls complete.
    - `billingStatus` string
    - `summary` MonitorSummary
      - `totalPages` integer
      - `same` integer
      - `changed` integer
      - `new` integer
      - `removed` integer
      - `error` integer
    - `targetResults` unknown[], nullable
      - unknown
    - `notificationStatus` object, nullable
    - `error` string, nullable
    - `createdAt` string, date-time
    - `updatedAt` string, date-time

## Other responses

- `409` — A monitor check is already running

---

[API](https://skmtc.dev/firecrawl/apis/firecrawl-api.md) · [All operations](https://skmtc.dev/firecrawl/apis/firecrawl-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/firecrawl/firecrawl-api/revisions/e350fafb5a2a/schema)