DatadogApi

The DatadogApi MCP Server offers a comprehensive suite of tools for managing and interacting with Datadog’s services. Users can leverage these tools to:

Authentication

The Arcade Datadog API MCP Server requires three environment variables to authenticate with the Datadog API :

• DATADOG_API_KEY
• DATADOG_APPLICATION_KEY
• DATADOG_BASE_URL

How to obtain your credentials:

1. Log in to your Datadog dashboard 
2. Navigate to Organization Settings (click your profile icon in the bottom left)
3. Go to API Keys → click New Key → provide a name and click Create Key
4. Go to Application Keys → click New Key → provide a name and click Create Key
5. Determine your Base URL based on your Datadog site (check the URL in your browser):
   • US1: api.datadoghq.com
   • US3: api.us3.datadoghq.com
   • US5: api.us5.datadoghq.com
   • EU1: api.datadoghq.eu
   • AP1: api.ap1.datadoghq.com
   • GOV: api.ddog-gov.com

For more details, see the Datadog API and Application Keys documentation .

Available Tools

DatadogApi.ListDatadogDatastores

Retrieve a list of all Datadog datastores.

Parameters

This tool does not take any parameters. Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.CreateNewDatastore

Creates a new datastore in Datadog.

Parameters

• datastore_description (string, optional) A human-readable description about the datastore.
• datastore_display_name (string, optional) The display name for the new datastore. This should be a human-readable and descriptive name.
• datastore_id (string, optional) Optional ID for the new datastore. If not provided, a default one will be generated automatically.
• datastore_resource_type (string, optional) Specifies the resource type for the datastore. Valid value is ‘datastores’.
• organization_access_level (string, optional) The access level for the datastore within the organization. Options: ‘contributor’, ‘viewer’, or ‘manager’.
• primary_key_column_name (string, optional) The name of the primary key column for this datastore. Must follow PostgreSQL naming conventions and not exceed 63 characters.
• primary_key_generation_strategy (string, optional) Set to uuid for automatic primary key generation when new items are added. Default is none, requiring manual key assignment.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.DeleteDatadogDatastore

Delete a Datadog datastore using its unique ID.

Parameters

• datastore_unique_id (string, required) The unique identifier of the datastore to delete in Datadog.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.RetrieveDatastore

Retrieve datastore information by ID.

Parameters

• datastore_identifier (string, required) The unique ID of the datastore to be retrieved from Datadog.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.UpdateDatastoreAttributes

Update attributes of an existing datastore in Datadog.

Parameters

• datastore_unique_identifier (string, required) The unique identifier of the datastore to update in Datadog.
• datastore_description (string, optional) A human-readable description for the datastore. Use this to provide additional information or context about the datastore.
• datastore_display_name (string, optional) The display name of the datastore to be updated. Provide a concise, human-readable name.
• datastore_update_id (string, optional) The unique identifier for the datastore that needs to be updated.
• resource_type_for_datastores (string, optional) Specifies the resource type for datastores. Must be ‘datastores’.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.DeleteDatastoreItem

Delete an item from a datastore by its key.

Parameters

• datastore_id (string, required) A string representing the unique identifier of the datastore from which the item will be deleted.
• item_primary_key (string, optional) The primary key value identifying the item to delete. Max length is 256 characters.
• item_unique_identifier (string, optional) Optional unique identifier of the item to delete. Use if available for more precise deletion.
• resource_type_for_datastore_items (string, optional) The resource type for datastore items. Must be ‘items’.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ListDatastoreItems

Retrieve items from a specified datastore.

Parameters

• datastore_identifier (string, required) The unique identifier for the datastore from which to fetch items.
• item_limit_per_page (integer, optional) Limit the number of items to return per page for pagination. Maximum of 100 items per page.
• pagination_offset (integer, optional) Specifies the number of items to skip from the beginning of the result set for pagination.
• primary_item_key (string, optional) Primary key to retrieve a specific item. Cannot be used with the filter parameter.
• search_filter (string, optional) Query filter to search datastore items using the logs search syntax. Cannot be used with item_key.
• sort_order (string, optional) Sort results by a specific field. Use ’-’ prefix for descending order (e.g., ‘-created_at’).

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.UpdateDatastoreItem

Partially update an item in a datastore by its key.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• datastore_identifier (string, optional) The unique identifier for the datastore that contains the item to update. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’.
• request_body (string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.BulkDeleteDatastoreItems

Delete multiple items from a datastore at once.

Parameters

• datastore_identifier (string, required) The unique ID of the datastore from which items will be deleted.
• datastore_items_id (string, optional) ID for the datastore of items you want to delete.
• item_keys_to_delete (array[string], optional) List of up to 100 primary keys identifying items to delete from the datastore.
• items_resource_type (string, optional) Specifies the resource type of the items. Must be ‘items’.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.BulkUpdateDatastoreItems

Perform bulk creation or replacement of datastore items.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• datastore_identifier (string, optional) The unique identifier for the datastore where items will be updated or replaced. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’.
• request_body (string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ListAppKeyRegistrations

Retrieve a list of app key registrations from Datadog.

Parameters

• page_number (integer, optional) The page number to return for paginating through app key registrations.
• results_per_page (integer, optional) The number of App Key Registrations to return per page.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.UnregisterAppKey

Unregister an application key to revoke its access.

Parameters

• app_key_id (string, required) The unique identifier of the application key to be unregistered.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.GetAppKeyRegistration

Retrieve details of an existing App Key Registration.

Parameters

• app_key_id (string, required) The unique ID of the app key to fetch its registration details.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.RegisterDatadogAppKey

Register a new app key in Datadog.

Parameters

• app_key_id (string, required) The unique identifier for the app key to be registered with Datadog. It must be a valid string.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.CreateActionConnection

Create a new action connection in Datadog.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• request_body (string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.DeleteActionConnection

Delete an existing action connection in Datadog.

Parameters

• action_connection_id (string, required) The unique identifier for the action connection to be deleted.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.GetActionConnection

Retrieve an existing Action Connection from Datadog.

Parameters

• action_connection_id (string, required) The ID of the action connection to retrieve. Required for fetching details of a specific connection.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.UpdateActionConnection

Update an existing action connection in Datadog.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• action_connection_id (string, optional) The unique identifier for the action connection to be updated in Datadog. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’.
• request_body (string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.GetAwsScanOptions

Fetch AWS scan options for configured accounts.

Parameters

This tool does not take any parameters. Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ActivateAwsScanOptions

Activate Agentless scan options for an AWS account.

Parameters

• aws_account_id (string, required) The ID of the AWS account for which to activate scan options.
• enable_container_vulnerability_scanning (boolean, required) Enable scanning for vulnerabilities in containers when set to true.
• enable_lambda_function_scanning (boolean, required) Enable scanning of Lambda functions. Set to true to enable, false to disable.
• enable_sensitive_data_scanning (boolean, required) Indicates if scanning for sensitive data is enabled for the AWS account.
• enable_vulnerability_scan_host_os (boolean, required) Indicates if scanning for vulnerabilities in host operating systems is enabled.
• resource_type (string, optional) Specifies the resource type to activate. Must be ‘aws_scan_options’.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.DeleteAwsScanOptions

Delete Agentless scan options for an AWS account.

Parameters

• aws_account_id (string, required) The unique identifier for the AWS account whose scan options you want to delete.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.FetchAwsScanSettings

Fetches Agentless scan options for AWS accounts.

Parameters

• aws_account_id (string, required) The unique ID of an AWS account for fetching scan options.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.UpdateAwsScanOptions

Update Agentless scan options for an AWS account.

Parameters

• account_identifier (string, required) The ID of the AWS account that needs scan options updated.
• aws_account_id (string, required) The ID of the AWS account for which to update scan options.
• enable_lambda_scanning (boolean, optional) Set to true to enable scanning of AWS Lambda functions.
• enable_sensitive_data_scanning (boolean, optional) Enable scanning for sensitive data in the AWS account. Set to true to enable.
• enable_vulnerability_scanning_for_containers (boolean, optional) Set to true to enable scanning for container vulnerabilities.
• enable_vulnerability_scanning_in_hosts (boolean, optional) Enable scanning for vulnerabilities in hosts. Set to true to enable, false to disable.
• resource_type (string, optional) Specifies the resource type. Must be set to aws_scan_options.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.FetchAzureScanOptions

Fetches the scan options for Azure accounts from Datadog.

Parameters

This tool does not take any parameters. Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ActivateAzureScanOptions

Activate Agentless scan options for Azure subscriptions.

Parameters

• azure_subscription_id (string, optional) The Azure subscription ID for which to activate the scan options.
• enable_container_vulnerability_scan (boolean, optional) Set to true to activate scanning for vulnerabilities in containers.
• enable_vulnerability_scan_hosts (boolean, optional) Indicate if scanning for vulnerabilities in Azure hosts is enabled. Set to true to activate.
• resource_type (string, optional) Specifies the resource type. Always use ‘azure_scan_options’.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.DeleteAzureSubscriptionScanOptions

Delete scan options for an Azure subscription.

Parameters

• azure_subscription_id (string, required) The unique identifier for the Azure subscription whose scan options you want to delete.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.GetAgentlessScanOptions

Fetch Azure Agentless scan options for a subscription.

Parameters

• azure_subscription_id (string, required) The Azure subscription ID to retrieve the Agentless scan options for.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.UpdateAzureScanOptions

Update Agentless scan options for an Azure subscription.

Parameters

• azure_subscription_id (string, required) The unique identifier for the Azure subscription to update scan options.
• azure_scan_options_resource_type (string, optional) Specifies the resource type for Azure scan options, must be ‘azure_scan_options’.
• azure_subscription_identifier (string, optional) The Azure subscription ID for which to update scan options.
• enable_container_vulnerability_scanning (boolean, optional) Enable or disable container vulnerability scanning. Set to true to enable, false to disable.
• enable_scanning_for_host_vulnerabilities (boolean, optional) Enable or disable scanning for vulnerabilities in host operating systems.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.FetchGcpScanOptions

Fetch GCP project scan options.

Parameters

This tool does not take any parameters. Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ActivateGcpScanOptions

Activate Agentless scan options for a GCP project.

Parameters

• enable_container_vulnerability_scanning (boolean, optional) Set to true to enable scanning for vulnerabilities in containers.
• enable_vulnerability_host_scanning (boolean, optional) Set to true to enable scanning for vulnerabilities in hosts in the GCP project.
• gcp_project_id (string, optional) The Google Cloud Platform project ID for which to activate the scan options.
• gcp_scan_resource_type (string, optional) The type of GCP scan options resource. This is typically ‘gcp_scan_options’.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.DeleteGcpScanOptions

Delete Agentless scan options for a GCP project.

Parameters

• gcp_project_id (string, required) The unique identifier for the Google Cloud Platform (GCP) project whose scan options you wish to delete.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.RetrieveGcpScanSettings

Retrieve GCP project agentless scan options.

Parameters

• gcp_project_id (string, required) The unique ID of the GCP project to retrieve scan options for.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.UpdateGcpScanOptions

Update scan options for a GCP project in Datadog.

Parameters

• gcp_project_id (string, required) The Google Cloud Platform project ID to update scan options for.
• enable_container_vulnerability_scanning (boolean, optional) Enable (True) or disable (False) scanning for vulnerabilities in containers.
• enable_host_vulnerability_scanning (boolean, optional) Indicate if scanning for vulnerabilities in host operating systems is enabled.
• gcp_scan_options_resource_type (string, optional) Specifies the GCP scan options resource type, typically set to ‘gcp_scan_options’.
• google_cloud_project_id (string, optional) The ID of the GCP project to update scan options for, used as an identifier.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.FetchRecentAwsOnDemandTasks

Retrieve the latest AWS on demand tasks.

Parameters

This tool does not take any parameters. Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.TriggerAwsResourceScan

Trigger a high-priority scan of an AWS resource.

Parameters

• aws_resource_arn (string, required) The ARN of the AWS resource to scan, such as EC2, Lambda, AMI, ECR, RDS, or S3.
• task_type (string, optional) The type of the on-demand task. This must always be set to ‘aws_resource’.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.GetAwsOnDemandTaskData

Fetch data of a specific AWS on-demand task in Datadog.

Parameters

• aws_task_uuid (string, required) The UUID of the AWS on-demand task to fetch data for. This is a unique identifier for the task.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ListApiKeys

Retrieve all API keys for your Datadog account.

Parameters

• api_key_filter (string, optional) String to filter API keys by specified criteria. Use it to narrow down the list based on specific string matches.
• created_after_date_filter (string, optional) Include API keys created on or after this date. Expected format: YYYY-MM-DD.
• filter_api_keys_by_category (string, optional) Filter API keys by the specified category.
• filter_by_remote_config_read_enabled (boolean, optional) Set to true to filter API keys with remote config read enabled; false otherwise.
• filter_created_before_date (string, optional) Include only API keys created on or before this date in the format YYYY-MM-DD.
• include_related_resources (string, optional) Comma-separated list of resource paths (created_by, modified_by) to include related data in the response.
• modified_after_date_filter (string, optional) Specify a date to include API keys modified on or after this date. Use YYYY-MM-DD format.
• modified_before_date (string, optional) Include API keys modified on or before this specified date. Format should be YYYY-MM-DD.
• page_size (integer, optional) Specifies the number of API keys returned in a single page; maximum value is 100.
• sort_by_attribute (string, optional) Attribute to sort API keys by. Use a minus sign for descending order.
• specific_page_number_to_return (integer, optional) The specific page number to return from the paginated list of API keys.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.CreateDatadogApiKey

Creates a new API key in Datadog.

Parameters

• api_key_name (string, required) Name of the API key to be created in Datadog. This should be a descriptive and unique string identifier.
• api_keys_resource_type (string, optional) Specify the resource type as ‘api_keys’.
• apikey_category (string, optional) Specifies the category for the API key. This categorizes the key for organizational purposes.
• remote_config_read_enabled (boolean, optional) Indicates whether to enable read access to remote config for the new API key. Expects a boolean value.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.DeleteDatadogApiKey

Delete an API key from Datadog.

Parameters

• api_key_id (string, required) The unique identifier of the API key to delete in Datadog.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.GetApiKeyDetails

Retrieves details of a specific Datadog API key.

Parameters

• api_key_id (string, required) The unique identifier for the Datadog API key to be retrieved.
• include_related_resources (string, optional) Comma-separated list of resource paths (created_by, modified_by) to include in the response.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.UpdateDatadogApiKey

Update an API key in Datadog.

Parameters

• api_key_id (string, required) The unique identifier for the API key to be updated in Datadog.
• api_key_name (string, required) The new name for the API key to be updated.
• key_id (string, required) ID of the API key to be updated in Datadog.
• api_key_category (string, optional) The category of the API key for the update operation.
• api_keys_resource_type (string, optional) Specifies the resource type for API keys. Must be ‘api_keys’.
• enable_remote_config_read (boolean, optional) Enable remote config read for the API key. Use true to enable, false to disable.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ListSpanMetrics

Retrieve configured span-based metrics from Datadog.

Parameters

This tool does not take any parameters. Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.CreateSpanMetric

Create a metric based on ingested spans in your organization.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• request_body (string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.DeleteSpanMetric

Delete a specific span-based metric from your organization.

Parameters

• metric_id (string, required) The unique identifier for the span-based metric to be deleted.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.GetSpanMetric

Retrieve a specific span-based metric from Datadog.

Parameters

• metric_name (string, required) The name of the span-based metric to be retrieved from Datadog.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.UpdateSpanMetric

Update a specific span-based metric in Datadog.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• span_metric_name (string, optional) The name of the span-based metric to update in Datadog. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’.
• request_body (string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.GetApmRetentionFilters

Retrieve the list of APM retention filters from Datadog.

Parameters

This tool does not take any parameters. Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.CreateApmRetentionFilter

Create a retention filter for indexing spans in Datadog.

Parameters

• enable_retention_filter (boolean, required) Set to true to enable the retention filter or false to disable it.
• retention_filter_name (string, required) The name for the retention filter to be created.
• search_query (string, required) The search query using span search syntax to define criteria for retention.
• span_sample_rate (number, required) Sample rate for spans matching the query. A value of 1.0 processes all matching spans.
• resource_type (string, optional) Specify the type of the resource, always use ‘apm_retention_filter’.
• retention_filter_type (string, optional) Set the type of retention filter. Must be ‘spans-sampling-processor’.
• trace_sample_rate (number, optional) Sample rate for traces with spans going through the filter. Use 1.0 to keep all matching traces.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ReorderApmRetentionFilters

Reorder execution order of APM retention filters.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• request_body (string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.DeleteApmRetentionFilter

Delete a specific APM retention filter from your organization.

Parameters

• retention_filter_id (string, required) The ID of the retention filter to delete. Default filters cannot be deleted.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.GetApmRetentionFilter

Retrieve details of a specific APM retention filter.

Parameters

• retention_filter_id (string, required) The unique identifier for the specific APM retention filter to retrieve.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.UpdateApmRetentionFilter

Update an APM retention filter in your organization.

Parameters

• enable_retention_filter (boolean, required) Set to true to enable or false to disable the retention filter.
• filter_id (string, required) The unique identifier for the retention filter that you want to update.
• filter_query (string, required) The search query for the retention filter, following the span search syntax.
• retention_filter_id (string, required) The unique ID of the retention filter to be updated.
• retention_filter_name (string, required) Specify the name of the retention filter to update.
• span_sample_rate (number, required) Sample rate to apply to spans going through this retention filter. A value of 1.0 keeps all spans matching the query. Expected to be a number between 0 and 1.
• resource_type (string, optional) Specifies the type of the APM retention filter resource, should be ‘apm_retention_filter’.
• retention_filter_type (string, optional) Specify the type of retention filter. Valid options are: ‘spans-sampling-processor’, ‘spans-errors-sampling-processor’, ‘spans-appsec-sampling-processor’.
• trace_sample_rate (number, optional) Sample rate for traces containing spans that pass through the retention filter. A value of 1.0 keeps all matching traces.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.DeleteMultipleDatadogApps

Delete multiple apps in Datadog using app IDs.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• request_body (string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ListApps

Retrieve a list of all apps with optional filters and sorting.

Parameters

• filter_by_app_name (string, optional) Filter the list of apps by specifying the app name.
• filter_by_creator_email (string, optional) Filter apps by the creator’s email address. This is used to narrow down apps created by a specific user.
• filter_by_creator_uuid (string, optional) Filter apps by the app creator’s UUID. Provide the UUID of the user who created the app to narrow down the results.
• filter_by_query (string, optional) Filter apps by the app name or the app creator’s name.
• filter_by_tags (string, optional) Filter apps by specifying tags. Separate multiple tags with commas.
• filter_self_service_enabled (boolean, optional) Filter apps by self-service enablement. True for enabled, false otherwise.
• include_published_apps (boolean, optional) Set to true to include only published apps, false to exclude them.
• page_number (integer, optional) The page number to return for paginated results.
• page_size (integer, optional) The number of apps to return per page.
• show_only_favorite_apps (boolean, optional) Set to true to filter and show only apps that you have marked as favorites.
• sort_fields_and_directions (array[string], optional) An array specifying the fields and directions (e.g., ‘name:asc’, ‘created_at:desc’) to sort apps by.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.CreateNewApp

Create a new app and return its ID using Datadog.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• request_body (string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.DeleteApp

Delete a specific app in Datadog.

Parameters

• app_id (string, required) The ID of the app to delete in Datadog. Ensure this ID is accurate to avoid unintentional deletions.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.GetAppDetails

Retrieve comprehensive details of a Datadog app.

Parameters

• application_id (string, required) The unique ID of the Datadog app to retrieve details for. Required for fetching app information.
• app_version (string, optional) Specify the app version to retrieve. Use a version number starting from 1, or special values latest and deployed for the latest or published version, respectively.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.UpdateAppVersion

Update an app by creating a new version.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• application_id (string, optional) The unique ID of the app to update. Required for creating a new version. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’.
• request_body (string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.UnpublishApp

Unpublish an app to remove its live version.

Parameters

• app_identifier (string, required) The ID of the app you want to unpublish, removing its live version.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.PublishAppOnDatadog

Publish an app for user access on Datadog.

Parameters

• app_id_of_app_to_publish (string, required) The unique identifier of the app you want to publish on Datadog.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ListApplicationKeys

Retrieve all application keys for your organization.

Parameters

• created_after_date (string, optional) Include application keys created on or after this date (YYYY-MM-DD).
• created_before_date (string, optional) Filters application keys created on or before this date. Expected format is YYYY-MM-DD.
• filter_application_keys (string, optional) Filter the application keys based on a specified string to narrow down the results.
• include_related_resource (string, optional) Specify ‘owned_by’ to include related resource information in the response.
• page_number (integer, optional) Specify the page number to return in the results.
• page_size (integer, optional) Specify the number of application keys to return per page. Maximum is 100.
• sort_keys_by_attribute (string, optional) Sort application keys by attribute such as ‘created_at’, ‘name’, or ‘last4’. Use a minus sign for descending order, e.g., ‘-name’.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.DeleteDatadogAppKey

Deletes an application key in Datadog.

Parameters

• application_key_id (string, required) The unique ID of the Datadog application key to delete.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.GetApplicationKey

Retrieve an application key for your organization from Datadog.

Parameters

• application_key_id (string, required) The unique identifier for the application key to retrieve details from Datadog.
• include_related_resource (string, optional) Resource path for related resources to include in the response. Currently, only owned_by is supported.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.UpdateDatadogAppKey

Edit a Datadog application key by ID.

Parameters

• app_key_id (string, required) The unique ID of the Datadog application key to be edited.
• application_key_id (string, required) The unique identifier for the Datadog application key that needs to be updated.
• application_key_name (string, optional) Name of the application key to be updated.
• application_key_scopes (array[string], optional) Array of scopes to grant the application key. Each scope is a string specifying a permission level.
• application_keys_resource_type (string, optional) Fixed value for the resource type, which should always be ‘application_keys’.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.GetAuditLogs

Retrieve events matching an Audit Logs search query.

Parameters

• audit_logs_search_query (string, optional) Search query using Audit Logs syntax to filter events.
• cursor_for_following_results (string, optional) Cursor to fetch subsequent pages of results. Use the cursor from the previous query’s response.
• max_event_timestamp (string, optional) Specify the maximum timestamp for requested events in ISO 8601 format.
• max_events_per_response (integer, optional) Specifies the maximum number of events to return in the response.
• sort_order_of_events (string, optional) Specify the order of events in the results. Use ‘timestamp’ for ascending and ‘-timestamp’ for descending order.
• start_time_filter (string, optional) Specify the minimum timestamp for requested events in the format YYYY-MM-DDTHH:MM:SSZ.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.SearchAuditLogs

Retrieve audit logs events based on a search query.

Parameters

• audit_logs_search_query (string, optional) A string representing the search query following the Audit Logs search syntax to filter the logs.
• max_events_limit (integer, optional) Specify the maximum number of events to include in the response, enabling efficient pagination.
• maximum_time_for_requested_events (string, optional) Maximum time for the requested events. Supports date, math, and regular timestamps (in milliseconds).
• minimum_time (string, optional) Minimum time for the requested events. Accepts date, math, or timestamps in milliseconds.
• pagination_cursor (string, optional) Cursor for retrieving subsequent pages of audit log results.
• sort_parameter (string, optional) Sort events by timestamp. Use ‘timestamp’ for ascending, ‘-timestamp’ for descending.
• time_offset_seconds (integer, optional) Time offset in seconds to apply to the query, adjusting the timeframe of the log search.
• timezone (string, optional) Specify the timezone for the query, using GMT, UTC, an offset like UTC+1, or a Timezone Database identifier like America/New_York.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ListAuthnMappings

Retrieve all AuthN Mappings in the organization.

Parameters

• filter_authn_mappings (string, optional) Filter all authentication mappings using a specific string to refine the results.
• filter_by_resource_type (string, optional) Filter results by mapping resource type. Can be ‘role’ or ‘team’. Defaults to ‘role’.
• page_number (integer, optional) The specific page number to return from the list of AuthN Mappings.
• page_size (integer, optional) Number of results per page, with a maximum value of 100.
• sort_authn_mappings_by (string, optional) Sort AuthN Mappings by the specified field. Options include fields like created_at, role_id, saml_assertion_attribute_id, etc. Prefix with ’-’ for descending order.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.CreateAuthnMapping

Creates a new AuthN Mapping in Datadog.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• request_body (string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.DeleteAuthnMapping

Delete an AuthN Mapping using its UUID.

Parameters

• authn_mapping_uuid (string, required) The unique identifier (UUID) of the AuthN Mapping to be deleted.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.GetAuthnMapping

Retrieve an AuthN Mapping by its UUID.

Parameters

• authn_mapping_uuid (string, required) The UUID of the AuthN Mapping to retrieve.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.EditAuthnMapping

Edit an AuthN Mapping in Datadog.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• authn_mapping_uuid (string, optional) The UUID of the AuthN Mapping to edit. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’.
• request_body (string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.SearchCases

Search and retrieve support cases from Datadog.

Parameters

• order_ascending (boolean, optional) Set to true for ascending order; false for descending.
• page_number (integer, optional) The specific page number to return in the search results.
• page_size (integer, optional) The number of results per page, with a maximum value of 100.
• search_query (string, optional) The search query to filter cases. Use keywords or phrases to specify your search criteria.
• sort_by_field (string, optional) Specify the field to sort by. Options are ‘created_at’, ‘priority’, or ‘status’.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.CreateSupportCase

Create a new support case in Datadog.

Parameters

• case_title (string, required) The title of the support case to be created. It should clearly summarize the issue or request.
• case_type_uuid (string, required) UUID representing the case type. Provide a valid UUID to specify the type of case being created.
• assignee_resource_type (string, optional) The type of resource for the assignee, usually ‘user’.
• assignee_user_id (string, optional) A unique identifier for the user assigned to the case. Typically a UUID string.
• case_description (string, optional) A detailed description of the support case. Include all relevant information about the issue or request.
• case_priority (string, optional) The priority of the support case. Valid values are NOT_DEFINED, P1, P2, P3, P4, P5.
• case_resource_type (string, optional) Specifies the type of resource being created. Always use “case” for this argument.
• project_id (string, optional) Provide the unique identifier of the project related to the support case.
• project_resource_type (string, optional) Specifies the project resource type. Must be ‘project’.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.GetAllProjects

Retrieve a list of all projects from Datadog.

Parameters

This tool does not take any parameters. Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.CreateProject

Create a new project in the system.

Parameters

• project_key (string, required) The unique key for the project. Cannot use the value ‘CASE’.
• project_name (string, required) Specify the name of the project to be created. It should be a descriptive string.
• project_resource_type (string, optional) Specifies the project resource type, which must be ‘project’.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.RemoveProject

Remove a project using its ID.

Parameters

• project_id (string, required) The unique identifier (UUID) of the project to be removed.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.GetProjectDetails

Retrieve details of a specific project using project ID.

Parameters

• project_uuid (string, required) The unique identifier (UUID) of the project for which details are required.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.RetrieveSupportCaseTypes

Retrieves all available support case types from Datadog.

Parameters

This tool does not take any parameters. Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.CreateCaseTypeInDatadog

Initiate the creation of a new case type in Datadog.

Parameters

• case_type_name (string, required) Specify the name of the case type to be created in Datadog.
• case_type_deleted_timestamp (string, optional) Timestamp indicating when the case type was deleted. Format should be a valid ISO 8601 string.
• case_type_description (string, optional) A brief textual description of the case type to be created in Datadog.
• case_type_emoji (string, optional) Emoji representing the case type. Use a short, descriptive Unicode emoji.
• case_type_resource_type (string, optional) Specify the resource type for the case. Must be ‘case_type’.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.GetAllCustomAttributes

Retrieve all custom attributes for cases in Datadog.

Parameters

This tool does not take any parameters. Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.DeleteCaseType

Delete a specific case type in Datadog.

Parameters

• case_type_uuid (string, required) The unique identifier (UUID) of the case type to be deleted.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.GetCustomAttributeConfigs

Retrieve all custom attribute configurations for a case type.

Parameters

• case_type_uuid (string, required) UUID for the case type to retrieve its custom attribute configurations.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.CreateCustomAttributeConfig

Create a custom attribute configuration for a specific case type.

Parameters

• allow_multiple_values (boolean, required) Indicates if multiple values can be set for the custom attribute.
• case_type_uuid (string, required) UUID of the case type for which the custom attribute config is to be created.
• custom_attribute_display_name (string, required) The display name for the custom attribute.
• custom_attribute_key (string, required) A string key used to search for the custom attribute. This is the identifier for the attribute.
• custom_attribute_type (string, required) Type of the custom attribute. Options: ‘URL’, ‘TEXT’, or ‘NUMBER’.
• custom_attribute_description (string, optional) Detailed description for the custom attribute. This helps define the attribute’s purpose and use.
• custom_attributes_config_type (string, optional) Specifies the JSON:API resource type for the custom attributes configuration. Must be ‘custom_attribute’.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.DeleteCustomAttributeConfig

Deletes a custom attribute configuration for a case type.

Parameters

• case_type_uuid (string, required) The UUID of the case type for which the custom attribute configuration should be deleted.
• custom_attribute_uuid (string, required) The UUID of the case custom attribute to be deleted.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.GetCaseDetails

Retrieve detailed information for a specific case.

Parameters

• case_identifier (string, required) The unique identifier for the case, either a UUID or a specific key, required to retrieve case details.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ArchiveCase

Archive a specific case in Datadog.

Parameters

• case_unique_id (string, required) The unique identifier or key of the case to be archived in Datadog.
• case_resource_type (string, optional) Specify ‘case’ as the resource type to identify the case resource.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.AssignCaseToUser

Assign a case to a specific user.

Parameters

• assignee_user_id (string, required) The UUID of the user to whom the case will be assigned.
• case_id (string, required) The unique identifier (UUID or key) of the case to be assigned.
• case_resource_type (string, optional) Specify the resource type. Must be set to ‘case’.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.UpdateCaseAttributes

Update attributes of a specific case.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• case_identifier (string, optional) The unique identifier or key for the case to be updated. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’.
• request_body (string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.AddCommentToCase

Add a comment to a specific case in Datadog.

Parameters

• case_identifier (string, required) The unique identifier (UUID or key) for the case to which the comment will be added.
• comment_message (string, required) The message content to be added as a comment on the case.
• case_resource_type (string, optional) Specify the type of resource, always set to ‘case’.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.DeleteCaseComment

Deletes a specific comment from a case.

Parameters

• case_identifier (string, required) The unique identifier or key of the case for which the comment will be deleted.
• timeline_cell_uuid (string, required) The UUID of the timeline cell containing the comment to be deleted. Required for specifying the exact comment.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.DeleteCaseCustomAttribute

Removes a custom attribute from a specified case.

Parameters

• case_custom_attribute_key (string, required) The key of the custom attribute to be removed from a case.
• case_identifier (string, required) The unique identifier or key of the case from which the custom attribute is to be deleted.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.UpdateCaseCustomAttribute

Update a custom attribute for a specific case in Datadog.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• case_identifier (string, optional) The UUID or key of the case to be updated. This identifies the specific case in Datadog. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’.
• custom_attribute_key (string, optional) The key for the custom attribute of the case to be updated. Provide the exact key name to ensure accurate updates. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’.
• request_body (string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.UpdateCaseDescription

Update the description of a case in Datadog.

Parameters

• case_uuid_or_key (string, required) The unique identifier (UUID or key) for the specific case you want to update in Datadog.
• new_case_description (string, required) Provide the new description text for the case you wish to update. This replaces the current case description.
• case_resource_type (string, optional) Specify the type of resource for the case. It must be ‘case’.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.UpdateCasePriority

Update the priority of a specific case.

Parameters

• case_identifier (string, required) The unique identifier for the case, either UUID or key.
• case_priority (string, optional) Specify the priority level of the case. Valid options are: ‘NOT_DEFINED’, ‘P1’, ‘P2’, ‘P3’, ‘P4’, ‘P5’.
• case_resource_type (string, optional) Specifies the type of resource, should be set to ‘case’.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.UpdateCaseStatus

Update the status of a specific case in Datadog.

Parameters

• case_status (string, required) Specify the status of the case. Valid values are ‘OPEN’, ‘IN_PROGRESS’, ‘CLOSED’.
• case_uuid_or_key (string, required) The unique identifier or key for the case to update its status in Datadog.
• case_resource_type (string, optional) Specifies the resource type of the case. Must be ‘case’.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.UpdateCaseTitle

Update the title of a specific case by ID.

Parameters

• case_identifier (string, required) The unique identifier (UUID or key) of the case whose title you want to update.
• new_case_title (string, required) The new title for the case to be updated.
• case_resource_type (string, optional) Specify the type of the case resource, which should be ‘case’.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.UnarchiveCase

Unarchive a specific support case in Datadog.

Parameters

• case_identifier (string, required) The unique identifier (UUID or key) of the case to be unarchived.
• case_resource_type (string, optional) The resource type of the case, must be ‘case’.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.UnassignCase

Unassigns a case from its current assignee.

Parameters

• case_identifier (string, required) The unique UUID or key representing the case to be unassigned in Datadog.
• case_resource_type (string, optional) Specifies the resource type of the case. Must be set to ‘case’.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ListSoftwareCatalogEntities

Retrieve entities from the software catalog.

Parameters

• exclude_snapshotted_entities (string, optional) Set to true to exclude entities that are snapshotted.
• filter_by_kind (string, optional) Filter entities by specifying the kind of entity, provided as a string.
• filter_by_name (string, optional) Filter entities by specifying their name.
• filter_by_owner (string, optional) Filter the entities by their owner using a specific owner name or ID.
• filter_by_reference (string, optional) Filter entities by their specific reference string.
• filter_by_relation_type (string, optional) Specify the relation type to filter entities. Options include: ‘RelationTypeOwns’, ‘RelationTypeOwnedBy’, ‘RelationTypeDependsOn’, ‘RelationTypeDependencyOf’, ‘RelationTypePartsOf’, ‘RelationTypeHasPart’, ‘RelationTypeOtherOwns’, ‘RelationTypeOtherOwnedBy’, ‘RelationTypeImplementedBy’, ‘RelationTypeImplements’.
• filter_by_uuid (string, optional) Filter entities by their UUID. Provide the UUID as a string to retrieve specific entities.
• include_relationship_data (string, optional) Specify which relationship data to include, such as ‘schema’, ‘raw_schema’, ‘oncall’, ‘incident’, or ‘relation’.
• max_entities_per_page (integer, optional) Specifies the maximum number of entities to return per page in the response.
• pagination_offset (integer, optional) The starting point for pagination of the returned list of entities.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ManageSoftwareCatalogEntity

Create or update entities in the Software Catalog.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• request_body (string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.DeleteCatalogEntity

Delete a single entity from the Software Catalog.

Parameters

• catalog_entity_identifier (string, required) The UUID or Entity Reference for the entity to be deleted from the Software Catalog.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ListCatalogKinds

Retrieve entity kinds from the Software Catalog.

Parameters

• filter_entity_name (string, optional) Filter entities in the Software Catalog by their name using a string value.
• filter_uuid (string, optional) Filter entities by their UUID in the catalog.
• max_kinds_in_response (integer, optional) Specify the maximum number of entity kinds to be returned in the response.
• page_offset (integer, optional) Specific offset to use as the beginning of the returned page. It determines where the data will start from in the list.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.UpdateSoftwareCatalogKind

Create or update kinds in the Software Catalog.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• request_body (string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.DeleteCatalogKind

Delete a kind from the Software Catalog.

Parameters

• catalog_kind_identifier (string, required) The unique identifier for the kind to delete from the Software Catalog.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ListCatalogEntityRelations

Retrieve entity relations from the software catalog.

Parameters

• filter_by_first_entity_reference (string, optional) Filter relations by the reference of the first entity in the relation.
• filter_relations_by_second_entity_reference (string, optional) Filter relations by the reference of the second entity in the relation.
• include_relationship_data (string, optional) Specify which relationship data to include: ‘entity’ or ‘schema’.
• maximum_relations_per_page (integer, optional) Maximum number of relations to include in the response.
• page_offset (integer, optional) The starting offset for the returned page of results.
• relation_type_filter (string, optional) Filter relations by type using predefined relation types such as ‘RelationTypeOwns’, ‘RelationTypeDependsOn’, etc.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.AggregatePipelineEvents

Aggregate CI pipeline event metrics and timeseries.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• request_body (string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ListCiPipelineEvents

Retrieve CI pipeline events based on a search query.

Parameters

• cursor_for_next_page (string, optional) Cursor to paginate through results. Use the cursor from the previous query.
• event_order (string, optional) Specifies the order of CI pipeline events in the results. Use ‘timestamp’ for ascending and ‘-timestamp’ for descending order.
• max_events_response (integer, optional) Specify the maximum number of events to include in the response. Accepts an integer value.
• maximum_timestamp (string, optional) Specify the maximum timestamp for the requested events. Format as an ISO 8601 string (e.g., 2023-10-01T00:00:00Z).
• min_timestamp (string, optional) Specify the earliest time for the events you want to retrieve. Use a timestamp string.
• search_query (string, optional) A search query using Datadog’s log syntax to filter CI pipeline events. Specify criteria to refine results.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.SearchCiPipelineEvents

Retrieve CI pipeline events matching a search query.

Parameters

• filter_to_time (string, optional) The maximum time for requested events; supports date, math, and timestamps (in milliseconds).
• max_events_per_page (integer, optional) Specify the maximum number of events to retrieve in a single response. This limits the number of events returned in one page of results.
• min_time_for_events (string, optional) Specify the minimum time for the requested events. Supports date, math expressions, and timestamps in milliseconds.
• pagination_cursor (string, optional) Use this to fetch the next set of results by providing the cursor value from the previous query response.
• query_time_offset_seconds (integer, optional) The time offset in seconds to apply to the query for event retrieval.
• search_query (string, optional) The search query using CI Visibility Explorer search syntax to filter pipeline events.
• sort_events_by (string, optional) Defines the order of CI pipeline events by timestamp. Use ‘timestamp’ for ascending order and ‘-timestamp’ for descending order.
• timezone (string, optional) Specify the timezone as GMT, UTC, a UTC offset (like UTC+1), or a Timezone Database identifier (e.g., America/New_York).

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.AggregateTestMetrics

Aggregate CI Visibility test events into metrics and timeseries.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• request_body (string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ListCiTestEvents

Retrieve CI test events based on a search query.

Parameters

• max_events_in_response (integer, optional) Specify the maximum number of CI test events to return in the response.
• max_timestamp (string, optional) Specify the maximum timestamp for the requested events.
• minimum_timestamp (string, optional) The minimum timestamp to filter requested events. Format is typically ISO 8601.
• pagination_cursor (string, optional) Cursor for fetching the next set of paginated results, provided by the previous query.
• search_query (string, optional) Search query using log syntax to filter CI Visibility test events.
• sort_order (string, optional) Specify the order of events by using ‘timestamp’ for ascending or ‘-timestamp’ for descending.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.SearchCiTestEvents

Retrieve CI Visibility test events with advanced search capabilities.

Parameters

• maximum_event_time (string, optional) The maximum time for the requested events. Supports date strings, math expressions, or timestamps (in milliseconds).
• maximum_events_in_response (integer, optional) Specify the maximum number of events to be returned in the response. This limits the size of the result set.
• pagination_cursor (string, optional) Cursor for retrieving the next set of paginated results based on previous queries.
• search_query (string, optional) The search query using CI Visibility Explorer syntax for filtering test events.
• sort_order (string, optional) Specify the sorting order for events. Use ‘timestamp’ for ascending or ‘-timestamp’ for descending order.
• start_time_filter (string, optional) The minimum time for requested events; can be a date, mathematical expression, or timestamp in milliseconds.
• time_offset_seconds (integer, optional) The time offset, in seconds, to apply to the query for adjusting the search time range.
• timezone (string, optional) Specify the timezone as GMT, UTC, a UTC offset (e.g., UTC+1), or a Timezone Database identifier (e.g., America/New_York).

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.CreateCustomSecurityFramework

Create a custom security framework in Datadog.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• request_body (string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.DeleteCustomFramework

Delete a custom framework from Datadog.

Parameters

• framework_handle (string, required) The unique identifier for the custom framework to be deleted.
• framework_version (string, required) Specify the version of the custom framework to delete.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.GetCustomFramework

Retrieve a specific custom framework by handle and version.

Parameters

• framework_handle (string, required) The unique identifier for the custom framework to retrieve.
• framework_version (string, required) Specify the version of the framework to retrieve. Use the exact version number or identifier.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.UpdateCustomFramework

Update an existing custom security management framework.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• framework_handle (string, optional) The unique identifier for the framework to update. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’.
• framework_version (string, optional) Specifies the version of the framework to be updated. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’.
• request_body (string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ListResourceFilters

Retrieve Datadog resource evaluation filters.

Parameters

• cloud_provider_account_id (string, optional) Filter resource filters by the cloud provider’s account ID. This is valid only when a provider is specified.
• cloud_provider_filter (string, optional) Specifies the cloud provider to filter resource filters, such as aws, gcp, or azure.
• skip_cache_for_resource_filters (boolean, optional) Set to true to skip the cache when fetching resource filters. Useful when the latest resource data is needed.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.UpdateResourceFilters

Update resource filters in cloud security management.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• request_body (string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ListContainerImages

Retrieve all container images for your organization.

Parameters

• filter_tags (string, optional) Comma-separated list of tags to filter container images by.
• group_container_images_by_tags (string, optional) Comma-separated list of tags to group container images by. Helps in organizing images based on specified criteria.
• max_results_per_page (integer, optional) The maximum number of container image results to return per page.
• next_page_cursor (string, optional) String to query the next page of container image results. Obtain this from the meta.pagination.next_cursor in the API response.
• sort_container_images_by (string, optional) Attribute to sort Container Images by, such as ‘name’ or ‘date’.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ListAllContainers

Retrieve all containers within your organization.

Parameters

• container_sort_attribute (string, optional) Specify the attribute to sort containers by. Common values include ‘name’, ‘creation_date’, etc.
• filter_by_tags (string, optional) Comma-separated list of tags to filter containers by, narrowing down the results based on specified tags.
• group_containers_by_tags (string, optional) Comma-separated list of tags to group containers by.
• maximum_results_returned (integer, optional) Maximum number of container results to return per page.
• pagination_cursor (string, optional) A string to query the next page of container results, using the meta.pagination.next_cursor from the API response.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ListCustomAllocationRules

Retrieve all custom allocation rules for the organization.

Parameters

This tool does not take any parameters. Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.CreateCustomAllocationRule

Create a custom allocation rule in Datadog.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• request_body (string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ReorderCustomAllocationRules

Change execution order of custom allocation rules in Datadog.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• request_body (string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.DeleteCustomAllocationRule

Delete an existing custom allocation rule by ID.

Parameters

• custom_allocation_rule_id (integer, required) The unique identifier of the custom allocation rule to be deleted.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.GetCustomAllocationRule

Retrieve a custom allocation rule by its ID.

Parameters

• custom_allocation_rule_id (integer, required) The unique identifier for retrieving a specific custom allocation rule in Datadog.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.UpdateCustomAllocationRule

Update custom allocation rules with new filters and strategies.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• custom_allocation_rule_id (integer, optional) The unique identifier for the custom allocation rule to update. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’.
• request_body (string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ListAwsCurConfigs

Retrieve AWS CUR configuration list from Datadog.

Parameters

This tool does not take any parameters. Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.CreateAwsCurConfig

Create an AWS CUR config for Cloud Cost Management.

Parameters

• aws_account_id (string, optional) The AWS account ID for which the CUR config is created. This is required to specify which AWS account the configuration applies to.
• aws_bucket_name_for_cur (string, optional) The AWS bucket name used to store the Cost and Usage Report.
• aws_cur_config_type (string, optional) Type of AWS CUR config post request. Choose from available options: ‘aws_cur_config_post_request’.
• bucket_region (string, optional) The AWS region where the bucket is located.
• excluded_aws_account_ids (array[string], optional) List of AWS account IDs to exclude from the billing dataset. Used when include_new_accounts is true.
• include_new_member_accounts (boolean, optional) Set to true to automatically include new member accounts by default in your billing dataset.
• included_aws_account_ids (array[string], optional) List of AWS account IDs to be included in the billing dataset, used when include_new_accounts is false.
• report_month (integer, optional) Specify the month for the AWS Cost and Usage Report. Use an integer (1-12) to represent the month.
• report_name (string, optional) The name of the Cost and Usage Report to create for AWS CUR configuration.
• report_prefix (string, optional) The prefix for the Cost and Usage Report (CUR).

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ArchiveCloudCostAccount

Archive a Cloud Cost Management Account.

Parameters

• cloud_account_id (integer, required) The unique identifier for the Cloud Account to be archived in Datadog.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.GetAwsCurConfig

Retrieve a specific AWS CUR configuration.

Parameters

• cloud_account_id (integer, required) The unique integer identifier of the AWS cloud account for which to fetch the CUR configuration.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.UpdateAwsCurConfigStatus

Updates status or configuration of an AWS CUR config.

Parameters

• cloud_account_id (integer, required) The ID of the AWS cloud account to configure in Datadog.
• automatic_inclusion_of_new_accounts (boolean, optional) Set to true to automatically include new member accounts by default in your billing dataset.
• aws_cur_config_request_type (string, optional) Specify the type of AWS CUR config Patch Request, usually ‘aws_cur_config_patch_request’.
• excluded_aws_account_ids (array[string], optional) List of AWS account IDs to exclude from the billing dataset when “include_new_accounts” is true.
• included_aws_accounts (array[string], optional) List of AWS account IDs to be included in the billing dataset when include_new_accounts is false.
• is_cost_management_enabled (boolean, optional) Indicates whether the Cloud Cost Management account is enabled. Accepts a boolean value.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ListAzureConfigs

Retrieve Azure configuration list from Datadog.

Parameters

This tool does not take any parameters. Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.CreateAzureCostManagementAccount

Create a Cloud Cost Management account for Azure.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• request_body (string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ArchiveAzureCostAccount

Archive an Azure Cloud Cost Management account in Datadog.

Parameters

• azure_cloud_account_id (integer, required) The ID of the Azure Cloud Cost Management account to archive. This is necessary to identify which account’s configurations will be removed.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.GetAzureConfig

Retrieve details of a specific Azure configuration.

Parameters

• azure_cloud_account_id (integer, required) The unique identifier for the Azure cloud account to retrieve the configuration.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.UpdateAzureConfigStatus

Update status of Azure config to active or archived.

Parameters

• cloud_account_id (integer, required) The identifier for the Azure Cloud account whose configuration status is being updated.
• azure_config_patch_request_type (string, optional) Specify the type of Azure config Patch Request, typically ‘azure_uc_config_patch_request’.
• enable_cloud_cost_management (boolean, optional) Set to true to enable the Cloud Cost Management account, false to disable it.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ManageBudget

Create or update a budget in Datadog.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• request_body (string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.DeleteBudget

Delete a specified budget.

Parameters

• budget_id (string, required) The unique identifier for the budget to be deleted. This ID is required to specify which budget to remove from the system.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.GetBudgetDetails

Retrieve detailed information about a specific budget.

Parameters

• budget_identifier (string, required) The unique identifier for the budget to retrieve details for.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ListBudgets

Fetch a list of budgets from Datadog.

Parameters

This tool does not take any parameters. Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ListCustomCostsFiles

Retrieve a list of custom costs files from Datadog.

Parameters

• filter_by_file_status (string, optional) Filter the custom costs files by their status. Accepts a string value representing the status to filter by, such as ‘active’, ‘inactive’, or ‘pending’.
• page_number (integer, optional) The page number to retrieve for pagination in the list of custom costs files.
• pagination_page_size (integer, optional) The number of custom cost files to return per page for pagination.
• sort_key (string, optional) Specify the key for sorting the list, with an optional ’-’ prefix for descending order.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.UploadCustomCostsFile

Upload a custom costs file to Datadog.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• request_body (string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.DeleteCustomCostFile

Delete a specified custom costs file in Datadog.

Parameters

• custom_cost_file_id (string, required) The unique identifier of the custom costs file to be deleted.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.FetchCustomCostsFile

Fetch a specified Custom Costs file by file ID from Datadog.

Parameters

• file_identifier (string, required) A unique identifier for the Custom Costs file to be retrieved from Datadog.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ListGcpUsageCostConfigs

Retrieve Google Cloud Usage Cost configurations from Datadog.

Parameters

This tool does not take any parameters. Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.CreateGcpCostManagementAccount

Create a cost management account for Google Cloud usage.

Parameters

• gcp_bucket_name (string, optional) The name of the Google Cloud bucket where the Usage Cost exports are stored.
• gcp_usage_cost_export_dataset_name (string, optional) The dataset name used for exporting the Google Cloud Usage Cost report.
• gcp_usage_cost_report_name (string, optional) The name of the Google Cloud Usage Cost report to be used for cost management.
• google_cloud_billing_account_id (string, optional) The Google Cloud account ID for cost management.
• google_cloud_export_prefix (string, optional) The export prefix for the Google Cloud Usage Cost report.
• google_cloud_service_account_email (string, optional) The unique Google Cloud service account email required for the cost management setup.
• usage_cost_config_type (string, optional) Specifies the type of Google Cloud Usage Cost configuration post request. Use “gcp_uc_config_post_request” to indicate this type.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ArchiveGcpCostManagementAccount

Archive a Cloud Cost Management account.

Parameters

• cloud_account_identifier (integer, required) The unique identifier for the GCP cloud account to be archived.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.GetGcpUsageCostConfig

Retrieve specific Google Cloud Usage Cost configuration details.

Parameters

• cloud_account_identifier (integer, required) The unique identifier of the Google Cloud account for which to retrieve the usage cost configuration.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.UpdateGcpUsageCostStatus

Update the status of a GCP Usage Cost config.

Parameters

• cloud_account_id (integer, required) The ID of the Google Cloud account for which the cost configuration status needs to be updated.
• cloud_cost_management_enabled (boolean, required) Set to ‘true’ to enable the Cloud Cost Management account or ‘false’ to disable it.
• gcp_usage_cost_config_request_type (string, optional) Type of Google Cloud Usage Cost configuration patch request. Use ‘gcp_uc_config_patch_request’.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.GetActiveBillingDimensions

Retrieve active billing dimensions for cost attribution.

Parameters

This tool does not take any parameters. Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.FetchMonthlyCostAttribution

Retrieve monthly cost attribution data by tag.

Parameters

• cost_types_fields (string, required) Comma-separated list specifying cost types and proportions. Use * to retrieve all fields. Example: infra_host_on_demand_cost,infra_host_percentage_in_account.
• start_month (string, required) Datetime in ISO-8601 format, UTC, precise to month [YYYY-MM]. Represents the start of the costing period.
• end_month (string, optional) The final month for cost calculation. Use ISO-8601 format [YYYY-MM] to specify the month.
• include_child_organization_costs (boolean, optional) Include child organization costs in the response. Defaults to true.
• pagination_next_record_id (string, optional) Identifier for fetching the next set of results in a paginated response. Use the ‘next_record_id’ from the previous response.
• sort_by_billing_dimension (string, optional) Billing dimension to sort by. Defaults to sorting by total cost. Example: ‘infra_host’.
• sort_by_direction (string, optional) Specifies the direction to sort cost attribution data. Use ‘desc’ for descending or ‘asc’ for ascending order.
• tag_keys_for_cost_grouping (string, optional) Comma-separated list of tag keys used to group costs. If empty, costs won’t be grouped by tag. Check tag_config_source in the API response for available tags.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ListAllCsmAgents

Retrieve all CSM Agents running on your infrastructure.

Parameters

• filter_query (string, optional) A search query string to filter results, e.g., hostname:COMP-T2H4J27423.
• page_size (integer, optional) Specify the number of items to include in a single page for pagination.
• pagination_page_index (integer, optional) The zero-based index of the page to retrieve for pagination.
• results_sort_direction (string, optional) Sets sort order for results. Use ‘asc’ for ascending or ‘desc’ for descending.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.GetCloudAccountsCoverageAnalysis

Retrieve CSM coverage analysis of your cloud accounts.

Parameters

This tool does not take any parameters. Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.GetCsmCoverageAnalysis

Retrieve CSM coverage analysis for hosts and containers.

Parameters

This tool does not take any parameters. Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.GetServerlessCoverageAnalysis

Retrieve CSM serverless coverage analysis data from Datadog.

Parameters

This tool does not take any parameters. Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ListServerlessAgents

Retrieve all running CSM Serverless Agents.

Parameters

• filter_query (string, optional) A search string to filter serverless agents, such as hostname:COMP-T2H4J27423.
• items_per_page (integer, optional) The number of items to include in a single page of results.
• page_index (integer, optional) The zero-based page index for pagination when retrieving serverless agents.
• sort_direction (string, optional) The direction to sort results: ‘asc’ for ascending or ‘desc’ for descending order.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.ListUserAppKeys

Retrieve all application keys for the current user.

Parameters

• created_after_date (string, optional) Include application keys created on or after this date in the results.
• filter_by_string (string, optional) Filter application keys by the specified string to narrow down the results.
• filter_created_at_end_date (string, optional) Include only application keys created on or before this date. Format: YYYY-MM-DD.
• include_related_resources (string, optional) Specify ‘owned_by’ to include related resources in the response.
• page_number (integer, optional) Specify the page number to retrieve application keys from.
• page_size (integer, optional) Specify the number of application keys per page. Maximum value is 100.
• sort_application_keys (string, optional) Specify the attribute to sort the application keys. Use a minus sign for descending order.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.CreateUserApplicationKey

Create an application key for the current user in Datadog.

Parameters

• application_key_name (string, required) The name of the application key to be created for the current user.
• application_key_resource_type (string, optional) Specifies the resource type, should always be ‘application_keys’.
• application_key_scopes (array[string], optional) List of scopes to grant the application key for accessing specific resources.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.DeleteUserApplicationKey

Delete an application key owned by the current user.

Parameters

• application_key_id (string, required) The ID of the application key to be deleted. Required to identify which key to remove.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.GetUserApplicationKey

Retrieve an application key owned by the current user.

Parameters

• application_key_id (string, required) The ID of the application key to retrieve, owned by the current user.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.EditUserAppKey

Edit an application key owned by the current user.

Parameters

• app_key_identifier (string, required) ID of the application key to be edited.
• application_key_id (string, required) The ID of the application key to be edited. Must be a valid string ID.
• application_key_name (string, optional) New name for the application key.
• application_key_resource_type (string, optional) Specifies the resource type for the application key. Use the value ‘application_keys’.
• application_key_scopes (array[string], optional) List of scopes to grant the application key. Each scope is a string defining permissions.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.DeleteDashboardFromList

Remove dashboards from a specified list in Datadog.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• dashboard_list_identifier (integer, optional) The unique integer ID of the dashboard list from which dashboards will be deleted. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’.
• request_body (string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.FetchDashboardListItems

Fetch details of dashboards in a list.

Parameters

• dashboard_list_id (integer, required) The unique integer ID of the dashboard list from which to retrieve dashboard definitions.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.AddDashboardsToList

Add dashboards to an existing list in Datadog.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• dashboard_list_identifier (integer, optional) Specify the integer ID of the dashboard list where dashboards will be added. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’.
• request_body (string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.UpdateDashboardListItems

Update dashboards in an existing dashboard list.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• dashboard_list_identifier (integer, optional) ID of the dashboard list to update with new items. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’.
• request_body (string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.GetAllDatasets

Retrieve all datasets configured for your organization.

Parameters

This tool does not take any parameters. Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.CreateDataset

Create a dataset with specified configurations.

Parameters

• mode (Enum ToolMode, required) Operation mode: ‘get_request_schema’ returns the OpenAPI spec for the request body, ‘execute’ performs the actual operation
• request_body (string, optional) Stringified JSON representing the request body. Required when mode is ‘execute’, ignored when mode is ‘get_request_schema’

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.DeleteDataset

Deletes a dataset using its ID.

Parameters

• dataset_identifier (string, required) The unique ID of the dataset to be deleted. Required for deletion.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.RetrieveDatasetInfo

Retrieve detailed information about a specific dataset from Datadog.

Parameters

• dataset_identifier (string, required) The unique identifier of the dataset to retrieve from Datadog.

Secrets

This tool requires the following secrets: DATADOG_API_KEY, DATADOG_APPLICATION_KEY, DATADOG_BASE_URL. You can obtain these from your Datadog Organization Settings  under API Keys and Application Keys. See the Authentication section above for detailed instructions and the Datadog API documentation  for more information.

DatadogApi.EditDataset

Edit the dataset using the specified ID.

Parameters