# List Datadog monitors

Canonical URL: https://docs.fuse.init.inc/integrations/datadog/actions/monitors.list

List monitors with documented page and page_size pagination via opaque versioned page cursor (p:N). Requires monitors_read.

Action ID: `monitors.list`
Provider: Datadog (`datadog`)
Contract version: 1

## Risk and exposure

- Risk: Read
- Idempotency: Safe — Safe to retry without coordination; repeats do not create additional side effects.
- Availability: Default
- Exposure: REST, SDK, MCP
- MCP hints: readOnly=true, destructive=false, idempotent=true, openWorld=true

## Required scopes

None.

## Input schema fields

- `page_size`
- `cursor`

## Output schema fields

- `monitors`
- `monitors[]`
- `monitors[].id`
- `monitors[].name`
- `monitors[].type`
- `monitors[].query`
- `monitors[].message`
- `monitors[].overall_state`
- `monitors[].creator`
- `monitors[].created_at`
- `monitors[].modified_at`
- `monitors[].tags`
- `monitors[].tags[]`
- `monitors[].priority`
- `next_cursor`

Provider overview: https://docs.fuse.init.inc/integrations/datadog
Actions index: https://docs.fuse.init.inc/integrations/datadog/actions
Exact canonical JSON contract: https://docs.fuse.init.inc/api/catalog/v1/providers/datadog/actions/monitors.list
Deployment-effective discovery: https://api.fuse.init.inc/v1/tenants/%7Btenant_id%7D/providers/datadog/actions