---
title: "Create a monitoring run"
method: POST
path: "/monitoring-runs"
tags: ["MonitoringRun"]
---

# Create a monitoring run

`POST /monitoring-runs`

Triggers a monitoring run to process monitoring workflows for the previous month across all tenants. This endpoint is designed to be called by GCP Cloud Scheduler. If startDate and endDate are not provided, they will be calculated as the previous month. The processing happens in the background and the endpoint returns immediately with a 200 status code.

## Headers

- `tenant-id` string

## Request body

- CreateMonitoringRunRequest
  - `startDate` string
  - `endDate` string

## Response `200`

Monitoring run request accepted and processing started in the background

- object

## Other responses

- `400` — Invalid request data
- `500` — Internal Server Error - An unexpected error occurred

---

[API](https://skmtc.net/certifyos/apis/certify-api-layer.md) · [All operations](https://skmtc.net/certifyos/apis/certify-api-layer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/certifyos/certify-api-layer/revisions/3d27e9019c7b/schema)