For AI agents: A markdown version of this page is available at https://dnd37xeb23o8n.cloudfront.net/jen.gilbert/astro-base/api/latest/slack-integration/update-a-slack-integration-channel.md. A documentation index is available at /llms.txt.
Language
Datadog site

Update a Slack integration channel

PATCHhttps://api.datadoghq.com/api/v1/integration/slack/configuration/accounts/{account_name}/channels/{channel_name}https://api.us3.datadoghq.com/api/v1/integration/slack/configuration/accounts/{account_name}/channels/{channel_name}https://api.us5.datadoghq.com/api/v1/integration/slack/configuration/accounts/{account_name}/channels/{channel_name}https://api.datadoghq.eu/api/v1/integration/slack/configuration/accounts/{account_name}/channels/{channel_name}https://api.ap1.datadoghq.com/api/v1/integration/slack/configuration/accounts/{account_name}/channels/{channel_name}https://api.ap2.datadoghq.com/api/v1/integration/slack/configuration/accounts/{account_name}/channels/{channel_name}https://api.uk1.datadoghq.com/api/v1/integration/slack/configuration/accounts/{account_name}/channels/{channel_name}https://api.ddog-gov.com/api/v1/integration/slack/configuration/accounts/{account_name}/channels/{channel_name}https://api.us2.ddog-gov.com/api/v1/integration/slack/configuration/accounts/{account_name}/channels/{channel_name}

Overview

Update a channel used in your Datadog-Slack integration.

This endpoint requires the manage_integrations permission.

Arguments

Path Parameters

Name
Type
Description
account_name [required]
string

Your Slack account name.

channel_name [required]
string

The name of the Slack channel being operated on.

Request

Body Data (required)

Payload describing fields and values to be updated.

Field
Type
Description
display
object

Configuration options for what is shown in an alert event message.

name
string

Your channel name.

Response

OK

The Slack channel configuration.

Field
Type
Description
display
object

Configuration options for what is shown in an alert event message.

name
string

Your channel name.

Code Example

Update a Slack integration channel
# Path parameters
export account_name="CHANGE_ME"
export channel_name="CHANGE_ME"

# Set your Datadog site and credentials
export DD_SITE="datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X PATCH "https://api.${DD_SITE}/api/v1/integration/slack/configuration/accounts/${account_name}/channels/${channel_name}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "display": {
    "message": true,
    "mute_buttons": false,
    "notified": true,
    "snapshot": true,
    "tags": true
  },
  "name": "#general"
}
EOF
# Path parameters
export account_name="CHANGE_ME"
export channel_name="CHANGE_ME"

# Set your Datadog site and credentials
export DD_SITE="us3.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X PATCH "https://api.${DD_SITE}/api/v1/integration/slack/configuration/accounts/${account_name}/channels/${channel_name}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "display": {
    "message": true,
    "mute_buttons": false,
    "notified": true,
    "snapshot": true,
    "tags": true
  },
  "name": "#general"
}
EOF
# Path parameters
export account_name="CHANGE_ME"
export channel_name="CHANGE_ME"

# Set your Datadog site and credentials
export DD_SITE="us5.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X PATCH "https://api.${DD_SITE}/api/v1/integration/slack/configuration/accounts/${account_name}/channels/${channel_name}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "display": {
    "message": true,
    "mute_buttons": false,
    "notified": true,
    "snapshot": true,
    "tags": true
  },
  "name": "#general"
}
EOF
# Path parameters
export account_name="CHANGE_ME"
export channel_name="CHANGE_ME"

# Set your Datadog site and credentials
export DD_SITE="datadoghq.eu"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X PATCH "https://api.${DD_SITE}/api/v1/integration/slack/configuration/accounts/${account_name}/channels/${channel_name}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "display": {
    "message": true,
    "mute_buttons": false,
    "notified": true,
    "snapshot": true,
    "tags": true
  },
  "name": "#general"
}
EOF
# Path parameters
export account_name="CHANGE_ME"
export channel_name="CHANGE_ME"

# Set your Datadog site and credentials
export DD_SITE="ap1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X PATCH "https://api.${DD_SITE}/api/v1/integration/slack/configuration/accounts/${account_name}/channels/${channel_name}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "display": {
    "message": true,
    "mute_buttons": false,
    "notified": true,
    "snapshot": true,
    "tags": true
  },
  "name": "#general"
}
EOF
# Path parameters
export account_name="CHANGE_ME"
export channel_name="CHANGE_ME"

# Set your Datadog site and credentials
export DD_SITE="ap2.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X PATCH "https://api.${DD_SITE}/api/v1/integration/slack/configuration/accounts/${account_name}/channels/${channel_name}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "display": {
    "message": true,
    "mute_buttons": false,
    "notified": true,
    "snapshot": true,
    "tags": true
  },
  "name": "#general"
}
EOF
# Path parameters
export account_name="CHANGE_ME"
export channel_name="CHANGE_ME"

# Set your Datadog site and credentials
export DD_SITE="uk1.datadoghq.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X PATCH "https://api.${DD_SITE}/api/v1/integration/slack/configuration/accounts/${account_name}/channels/${channel_name}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "display": {
    "message": true,
    "mute_buttons": false,
    "notified": true,
    "snapshot": true,
    "tags": true
  },
  "name": "#general"
}
EOF
# Path parameters
export account_name="CHANGE_ME"
export channel_name="CHANGE_ME"

# Set your Datadog site and credentials
export DD_SITE="ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X PATCH "https://api.${DD_SITE}/api/v1/integration/slack/configuration/accounts/${account_name}/channels/${channel_name}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "display": {
    "message": true,
    "mute_buttons": false,
    "notified": true,
    "snapshot": true,
    "tags": true
  },
  "name": "#general"
}
EOF
# Path parameters
export account_name="CHANGE_ME"
export channel_name="CHANGE_ME"

# Set your Datadog site and credentials
export DD_SITE="us2.ddog-gov.com"
# Use a Personal Access Token or Service Access Token
export DD_BEARER_TOKEN="<PERSONAL_ACCESS_TOKEN OR SERVICE_ACCESS_TOKEN>"

curl -X PATCH "https://api.${DD_SITE}/api/v1/integration/slack/configuration/accounts/${account_name}/channels/${channel_name}" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
  "display": {
    "message": true,
    "mute_buttons": false,
    "notified": true,
    "snapshot": true,
    "tags": true
  },
  "name": "#general"
}
EOF