---
title: "Run a data observability monitor"
method: POST
path: "/api/v2/data-observability/monitors/{monitor_id}/run"
tags: ["Data Observability"]
---

# Run a data observability monitor

`POST /api/v2/data-observability/monitors/{monitor_id}/run`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/data-observability/monitors/{monitor_id}/run`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token` scopes: `data_observability_monitors_write`, `monitors_write`

Manually triggers a run for a data observability monitor. Only monitors that are not scheduled (manually-runnable) can be triggered this way.

## Path parameters

- `monitor_id` integer, required

## Response `200`

OK

- RunDataObservabilityMonitorResponse: The response returned when a data observability monitor run is triggered.
  - `data` RunDataObservabilityMonitorResponseData, required: The data object returned when a data observability monitor run is triggered.
    - `id` string, required: The unique identifier of the monitor run.
    - `type` 'monitor_run', required: The JSON:API resource type for a data observability monitor run.

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)