POST https://api.ap1.datadoghq.com/api/v2/integration/statuspage/url_settingshttps://api.ap2.datadoghq.com/api/v2/integration/statuspage/url_settingshttps://api.datadoghq.eu/api/v2/integration/statuspage/url_settingshttps://api.ddog-gov.com/api/v2/integration/statuspage/url_settingshttps://api.us2.ddog-gov.com/api/v2/integration/statuspage/url_settingshttps://api.datadoghq.com/api/v2/integration/statuspage/url_settingshttps://api.us3.datadoghq.com/api/v2/integration/statuspage/url_settingshttps://api.us5.datadoghq.com/api/v2/integration/statuspage/url_settings
Overview
Create a Statuspage URL setting for your organization.
This endpoint requires the manage_integrations permission.
Request
Body Data (required)
Statuspage URL setting payload.
Expand All
Statuspage URL setting data for a create request.
The Statuspage URL setting attributes for a create request.
Comma-separated list of custom tags to apply to events generated from this Statuspage URL.
The Statuspage URL to monitor. Must be a status.io or statuspage.com URL.
Statuspage URL setting resource type.
Allowed enum values: statuspage-url-setting
default: statuspage-url-setting
{
"data": {
"attributes": {
"custom_tags": "team:collaboration-integrations,env:prod",
"url": "https://example.statuspage.io"
},
"type": "statuspage-url-setting"
}
}
Response
CREATED
Response containing a Statuspage URL setting.
Expand All
Statuspage URL setting data from a response.
The attributes from a Statuspage URL setting response.
Comma-separated list of custom tags applied to events generated from this Statuspage URL.
The Statuspage URL being monitored.
The ID of the Statuspage URL setting.
Statuspage URL setting resource type.
Allowed enum values: statuspage-url-setting
default: statuspage-url-setting
{
"data": {
"attributes": {
"custom_tags": "team:collaboration-integrations,env:prod",
"url": "https://example.statuspage.io"
},
"id": "596da4af-0563-4097-90ff-07230c3f9db3",
"type": "statuspage-url-setting"
}
}
Bad Request
{
"errors": [
"Bad Request"
]
}
Forbidden
{
"errors": [
"Bad Request"
]
}
Conflict
{
"errors": [
"Bad Request"
]
}
Too many requests
{
"errors": [
"Bad Request"
]
}
Code Example
## default
#
# Curl command
curl -X POST "https://api.ap1.datadoghq.com"https://api.ap2.datadoghq.com"https://api.datadoghq.eu"https://api.ddog-gov.com"https://api.us2.ddog-gov.com"https://api.datadoghq.com"https://api.us3.datadoghq.com"https://api.us5.datadoghq.com/api/v2/integration/statuspage/url_settings" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_APP_KEY}" \
-d @- << EOF
{
"data": {
"attributes": {
"custom_tags": "team:collaboration-integrations",
"url": "https://example.statuspage.io"
},
"type": "statuspage-url-setting"
}
}
EOF