# Run Monitor (/api-reference/endpoint/monitor-run)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 1133 · updated: 2026-07-30 -->
Related: [Search](/api-reference/endpoint/search.md), [Search Feedback](/api-reference/endpoint/search-feedback.md), [Scrape](/api-reference/endpoint/scrape.md), [Batch Scrape](/api-reference/endpoint/batch-scrape.md), [Get Batch Scrape Status](/api-reference/endpoint/batch-scrape-get.md), [Cancel Batch Scrape](/api-reference/endpoint/batch-scrape-delete.md)



`POST /monitor/{monitorId}/run`

Run a monitor

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "parameters": [
    {
      "name": "monitorId",
      "in": "path",
      "required": true,
      "schema": {
        "type": "string",
        "format": "uuid"
      },
      "description": "The monitor ID"
    }
  ],
  "responses": {
    "200": {
      "description": "Monitor check queued",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "success": {
                "type": "boolean"
              },
              "id": {
                "type": "string",
                "format": "uuid"
              },
              "data": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "monitorId": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "queued",
                      "running",
                      "completed",
                      "failed",
                      "partial",
                      "skipped_overlap"
                    ]
                  },
                  "trigger": {
                    "type": "string",
                    "enum": [
                      "scheduled",
                      "manual"
                    ]
                  },
                  "scheduledFor": {
                    "type": "string",
                    "format": "date-time",
                    "nullable": true
                  },
                  "startedAt": {
                    "type": "string",
                    "format": "date-time",
                    "nullable": true
                  },
                  "finishedAt": {
                    "type": "string",
                    "format": "date-time",
                    "nullable": true
                  },
                  "estimatedCredits": {
                    "type": "integer",
                    "nullable": true,
                    "description": "Upper-bound credits reserved for this check before Firecrawl knows how many pages changed and require judging."
                  },
                  "reservedCredits": {
                    "type": "integer",
                    "nullable": true
                  },
                  "actualCredits": {
                    "type": "integer",
                    "nullable": true,
                    "description": "Final credits charged for this check after scrapes, crawls, and any changed-page judge calls complete."
                  },
                  "billingStatus": {
                    "type": "string"
                  },
                  "summary": {
                    "type": "object",
                    "properties": {
                      "totalPages": {
                        "type": "integer"
                      },
                      "same": {
                        "type": "integer"
                      },
                      "changed": {
                        "type": "integer"
                      },
                      "new": {
                        "type": "integer"
                      },
                      "removed": {
                        "type": "integer"
                      },
                      "error": {
                        "type": "integer"
                      }
                    }
                  },
                  "targetResults": {
                    "type": "array",
                    "nullable": true
                  },
                  "notificationStatus": {
                    "type": "object",
                    "nullable": true
                  },
                  "error": {
                    "type": "string",
                    "nullable": true
                  },
                  "createdAt": {
                    "type": "string",
                    "format": "date-time"
                  },
                  "updatedAt": {
                    "type": "string",
                    "format": "date-time"
                  }
                }
              }
            }
          }
        }
      }
    },
    "409": {
      "description": "A monitor check is already running"
    }
  }
}
```