> This page is for Workforce.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Datadog

**Authentication:** API key + application key. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow.

## Sample use cases

* Show me every monitor that fired in the last 24 hours, grouped by service.
* Pull p99 latency for the `checkout` service over the last hour and flag spikes.
* Mute the `db-replica-lag` monitor for 4 hours while we run the migration.

## Available Tools

#### list_dashboards

List all visualization dashboards for monitoring infrastructure, applications, and business metrics.

#### create_dashboard

Create a new visualization dashboard with custom widgets for monitoring metrics, logs, and application performance.

#### get_dashboard

Get detailed dashboard configuration including all widgets, layout, and template variables by ID.

#### update_dashboard

Update existing dashboard configuration including title, widgets, layout, and template variables.

#### delete_dashboard

Permanently delete a dashboard by ID removing all widgets and configuration.

#### list_downtimes

List all scheduled downtimes with filtering and pagination.

#### create_downtime

Create a scheduled downtime for maintenance windows. Specify scope, start/end times, and optional message. Returns created downtime with ID. Error: Check scope format and timestamps if creation fails.

#### get_downtime

Get a specific downtime by ID with full configuration. Returns downtime schedule, scope, and status. Error: Use list_downtimes to find valid downtime IDs if not found.

#### update_downtime

Update an existing downtime's configuration including scope, time range, or message.

#### delete_downtime

Delete a downtime schedule permanently by ID. This removes the maintenance window. Returns confirmation with deleted downtime ID. Error: Verify downtime_id with list_downtimes if deletion fails.

#### list_incidents

List all incidents with pagination.

#### create_incident

Create a new incident with title and impact status.

#### search_incidents

Search incidents with advanced query filters. Supports filtering by state, severity, customer impact, and custom fields. Returns matching incidents. Error: Check query syntax if search fails.

#### list_log_indexes

List all log indexes with filtering and pagination.

#### list_metrics

List all active metrics being reported to Datadog.

#### get_metric

Get metadata for a specific metric including type, description, and unit. Provide the metric name to retrieve details. Error: Use list_metrics to find valid metric names if not found.

#### update_metric

Update metadata for a metric including description, type, and unit. Provide metric name and fields to update. Returns updated metric metadata. Error: Use get_metric first to verify metric exists.

#### query_timeseries

Query timeseries data for metrics over a time range.

#### submit_metrics

Submit custom metric data points to Datadog.

#### list_monitors

List all monitoring alerts with filtering and pagination.

#### create_monitor

Create a new monitoring alert with thresholds and notification settings.

#### get_monitor

Get a specific monitor by ID with full configuration details. Returns monitor with thresholds, query, message, and current state. Error: Use list_monitors to find valid monitor IDs if not found.

#### update_monitor

Update an existing monitor's configuration including query, thresholds, or notification settings.

#### delete_monitor

Delete a monitor permanently by ID. This removes all alert configuration and history. Returns confirmation with deleted monitor ID. Error: Verify monitor_id with list_monitors if deletion fails.

#### mute_monitor

Mute a monitor to suppress notifications temporarily or indefinitely for maintenance windows.

#### unmute_monitor

Unmute a previously muted monitor to resume sending notifications. Specify optional scope to unmute. Error: Use list_monitors to find muted monitors.

#### list_roles

List all roles with pagination (admin-only: requires user_access_manage permission).

#### create_role

Create a new custom role (admin-only: requires user_access_manage permission). Specify unique role name. Returns created role with ID. Error: Check role name uniqueness if creation fails.

#### get_role

Get role details by ID (admin-only: requires user_access_manage permission). Returns role with name, user count, and timestamps. Error: Use list_roles to find valid role IDs if not found.

#### update_role

Update role name and description (admin-only: requires user_access_manage permission). Provide role_id and new name. Returns updated role. Error: Use get_role first to verify role exists.

#### delete_role

Delete custom role permanently by ID (admin-only: requires user_access_manage permission).

#### list_role_permissions

List permissions for a role (admin-only: requires user_access_manage permission). Returns permission IDs, names, descriptions, and categories. Error: Use list_roles to find valid role IDs.

#### add_role_permission

Grant permission to role (admin-only: requires user_access_manage permission).

#### remove_role_permission

Revoke permission from role (admin-only: requires user_access_manage permission).

#### get_role_users

List users with this role (admin-only: requires user_access_manage permission). Returns user IDs assigned to the role. Error: Use list_roles to find valid role IDs.

#### add_user_to_role

Assign user to role (admin-only: requires user_access_manage permission). Provide role_id and user_id. Returns updated user list for role. Error: Use list_users to find valid user IDs.

#### remove_user_from_role

Remove user from role (admin-only: requires user_access_manage permission). Provide role_id and user_id. Returns updated user list for role. Error: Use get_role_users to find assigned users.

#### list_all_permissions

List all available permissions in Datadog. Returns permission IDs, names, descriptions, and categories for role assignment. Error: Check API credentials if no permissions returned.

#### search_permissions

Search permissions by keyword. Provide search query to filter permissions by name or description. Returns matching permissions. Error: Try broader search terms if no results found.

#### list_synthetics_tests

List all synthetic monitoring tests with pagination.

#### create_synthetics_test

Create a new synthetic monitoring test (API or browser test).

#### list_global_variables

List all global variables for synthetics tests with pagination.

#### create_global_variable

Create a new global variable for reuse across synthetics tests.

#### list_all_locations

List all available testing locations for synthetics tests.

#### list_users

List all users with filtering and pagination (admin-only: requires user_access_manage permission).

#### create_user

Create a new user account (admin-only: requires user_access_manage permission).

#### update_user

Update user profile including name, email, or disabled status (admin-only: requires user_access_manage permission).

#### send_user_invitations

Send email invitations to new users (admin-only: requires user_access_manage permission). Provide list of email addresses. Returns invitation results. Error: Check email format if invitation fails.

#### search_logs

Search log events using Datadog query syntax (e.g. 'service:web status:error'). Supports time range and index filtering.