Explore documentation
  1. Welcome to Uptime 👋
  2. Frequently Asked Questions
  3. On-call scheduling and alerting
    1. Get started
    2. Slack and other integrations ↗
    3. Connecting external calendars
    4. Advanced guide
  4. Incidents
    1. Get started
    2. Post mortems
    3. Metadata & Catalog
    4. Screening alerts
    5. Reporting ↗
  5. Monitoring
    1. Get started
    2. Working with monitors
    3. Customizing monitors
    4. Monitor types
  6. Status pages
    1. Get started
    2. Advanced guide
  7. Uptime API
    1. Getting an API token
    2. Monitors
    3. Heartbeats
    4. On-call & incidents
    5. Status pages
    6. Metadata
    7. Integrations
      1. New Relic
      2. Datadog
        1. List Datadog integrations GET
        2. Get Datadog integration GET
        3. Create Datadog integration POST
        4. Update Datadog integration PATCH
        5. Remove Datadog integration DELETE
      3. AWS CloudWatch
      4. Microsoft Azure
      5. Google Monitoring
      6. Grafana
      7. Elastic
      8. Prometheus
      9. Email
      10. Incoming webhooks
      11. Atlassian Jira
      12. Slack
      13. Outgoing webhooks
      14. Splunk On-Call
      15. PagerDuty
      16. Catalog
    8. Team members
    9. Organization roles
    10. Usage
    11. Reporting

Update Datadog integration

Update an existing Datadog integration. Send only the parameters you wish to change (eg. paused).

PATCH https://uptime.betterstack.com/api/v2/datadog-integrations/{datadog_integration_id}

URL parameters

datadog_integration_id
required string

The ID of the Datadog integration you want to update

Headers

Authorization
required string

Bearer $TOKEN

Content-Type
string

application/json

Body parameters

name
string

The name of the Datadog integration that you can see in the dashboard.

policy_id
string

ID of the escalation policy associated with the Datadog integration.

call
boolean

Call the on-call person.

sms
boolean

Send an SMS to the on-call person.

email
boolean

Send an e-mail to the on-call person.

push
boolean

Send a push notification to the on-call person.

critical_alert
boolean

Send a critical push notification that ignores the mute switch and Do not Disturb mode.

team_wait
integer

How long we wait before escalating the incident alert to the team. In seconds.

recovery_period
integer

How long the alert must be up to automatically mark an incident as resolved. In seconds.

paused
boolean

Set to true to pause the integration, false to unpause it.

alerting_rule
string

Should we alert only on alarms, or on both alarms and warnings. Possible values: alert, alert_and_warn. Defaults to alert.

200

Returns the updated Datadog integration

Response body

{
  "data": {
    "id": "37",
    "type": "datadog_integration",
    "attributes": {
      "call": false,
      "sms": true,
      "email": true,
      "team_wait": 180,
      "recovery_period": null,
      "policy_id": null,
      "push": false,
      "critical_alert": false,
      "name": "Datadog alerts",
      "webhook_url": "https://uptime.betterstack.com/api/v1/datadog/webhook/[token]",
      "team_name": "Testing",
      "paused": true,
      "alerting_rule": "alert"
    }
  }
}

Example cURL

Example
curl -X "PATCH" "https://uptime.betterstack.com/api/v2/datadog-integrations/37" \
     -H "Authorization: Bearer $TOKEN" \
     -H 'Content-Type: application/json; charset=utf-8' \
     -d $'{
  "paused": true
}'


Previous article

Create Datadog integration

Next article

Remove Datadog integration