PagerDuty Integration
Security Monitoring is now available Security Monitoring is now available

PagerDuty Integration

Configure your Datadog-PagerDuty integration directly through the Datadog API.

Create a new service object

post https://api.datadoghq.comhttps://api.datadoghq.eu/api/v1/integration/pagerduty/configuration/services

Overview

Create a new service object in the PagerDuty integration.

Request

Body Data (required)

Create a new service object request body.

Expand All

Field

Type

Description

service_key [required]

string

Your service key in PagerDuty.

service_name [required]

string

Your service name associated with a service key in PagerDuty.

{
  "service_key": "string",
  "service_name": "string"
}

Response

OK

PagerDuty service object name.

Expand All

Field

Type

Description

service_name [required]

string

Your service name associated service key in PagerDuty.

{
  "service_name": "string"
}

Bad Request

Error response object.

Expand All

Field

Type

Description

errors [required]

[string]

Array of errors returned by the API.

{
  "errors": [
    "Bad Request"
  ]
}

Authentication error

Error response object.

Expand All

Field

Type

Description

errors [required]

[string]

Array of errors returned by the API.

{
  "errors": [
    "Bad Request"
  ]
}

Code Example


                                        # Curl command
curl -X post https://api.datadoghq.comhttps://api.datadoghq.eu/api/v1/integration/pagerduty/configuration/services \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_CLIENT_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_CLIENT_APP_KEY}" \
-d @- << EOF
{
  "service_key": null,
  "service_name": null
}
EOF

Delete a single service object

delete https://api.datadoghq.comhttps://api.datadoghq.eu/api/v1/integration/pagerduty/configuration/services/{service_name}

Overview

Delete a single service object in the Datadog-PagerDuty integration.

Arguments

Path Parameters

Name

Type

Description

service_name [required]

string

The service name

Response

OK

Authentication error

Error response object.

Expand All

Field

Type

Description

errors [required]

[string]

Array of errors returned by the API.

{
  "errors": [
    "Bad Request"
  ]
}

Item Not Found

Error response object.

Expand All

Field

Type

Description

errors [required]

[string]

Array of errors returned by the API.

{
  "errors": [
    "Bad Request"
  ]
}

Code Example


                                        # Path parameters
export service_name="CHANGE_ME"
# Curl command
curl -X delete https://api.datadoghq.comhttps://api.datadoghq.eu/api/v1/integration/pagerduty/configuration/services/${service_name} \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_CLIENT_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_CLIENT_APP_KEY}"

Get a single service object

get https://api.datadoghq.comhttps://api.datadoghq.eu/api/v1/integration/pagerduty/configuration/services/{service_name}

Overview

Get service name in the Datadog-PagerDuty integration.

Arguments

Path Parameters

Name

Type

Description

service_name [required]

string

The service name.

Response

OK

PagerDuty service object name.

Expand All

Field

Type

Description

service_name [required]

string

Your service name associated service key in PagerDuty.

{
  "service_name": "string"
}

Authentication error

Error response object.

Expand All

Field

Type

Description

errors [required]

[string]

Array of errors returned by the API.

{
  "errors": [
    "Bad Request"
  ]
}

Item Not Found

Error response object.

Expand All

Field

Type

Description

errors [required]

[string]

Array of errors returned by the API.

{
  "errors": [
    "Bad Request"
  ]
}

Code Example


                                        # Path parameters
export service_name="CHANGE_ME"
# Curl command
curl -X get https://api.datadoghq.comhttps://api.datadoghq.eu/api/v1/integration/pagerduty/configuration/services/${service_name} \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_CLIENT_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_CLIENT_APP_KEY}"

Update a single service object

put https://api.datadoghq.comhttps://api.datadoghq.eu/api/v1/integration/pagerduty/configuration/services/{service_name}

Overview

Update a single service object in the Datadog-PagerDuty integration.

Arguments

Path Parameters

Name

Type

Description

service_name [required]

string

The service name

Request

Body Data (required)

Update an existing service object request body.

Expand All

Field

Type

Description

service_key [required]

string

Your service key in PagerDuty.

{
  "service_key": "string"
}

Response

OK

Bad Request

Error response object.

Expand All

Field

Type

Description

errors [required]

[string]

Array of errors returned by the API.

{
  "errors": [
    "Bad Request"
  ]
}

Authentication error

Error response object.

Expand All

Field

Type

Description

errors [required]

[string]

Array of errors returned by the API.

{
  "errors": [
    "Bad Request"
  ]
}

Item Not Found

Error response object.

Expand All

Field

Type

Description

errors [required]

[string]

Array of errors returned by the API.

{
  "errors": [
    "Bad Request"
  ]
}

Code Example


                                        # Path parameters
export service_name="CHANGE_ME"
# Curl command
curl -X put https://api.datadoghq.comhttps://api.datadoghq.eu/api/v1/integration/pagerduty/configuration/services/${service_name} \
-H "Content-Type: application/json" \
-H "DD-API-KEY: ${DD_CLIENT_API_KEY}" \
-H "DD-APPLICATION-KEY: ${DD_CLIENT_APP_KEY}" \
-d @- << EOF
{
  "service_key": null
}
EOF