Datadog API

Use these operations to interact with the Datadog integration in Cortex.

Required permissions

Your API key must have the Configure integrations permission.

Operations

Retrieve configurations

get

Authorizations

Responses

application/json

application/json

application/problem+json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.getcortexapp.com/api/v1/datadog/configurations' \
  --header 'Authorization: Bearer JWT'

200

400

429

200

{
  "configurations": [
    {
      "alias": "text",
      "customSubdomain": "text",
      "environments": [
        "text"
      ],
      "isDefault": true,
      "lastFourApiKey": "text",
      "lastFourAppKey": "text",
      "region": "EU1"
    }
  ]
}

Successfully found configurations

Retrieve default configuration

get

Authorizations

Responses

application/json

application/json

application/problem+json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.getcortexapp.com/api/v1/datadog/default-configuration' \
  --header 'Authorization: Bearer JWT'

200

400

429

200

{
  "alias": "text",
  "customSubdomain": "text",
  "environments": [
    "text"
  ],
  "isDefault": true,
  "lastFourApiKey": "text",
  "lastFourAppKey": "text",
  "region": "EU1"
}

Successfully found default configuration

Retrieve a configuration

get

Authorizations

Path parameters

aliasstringrequired

Responses

application/json

application/json

application/json

application/problem+json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api.getcortexapp.com/api/v1/datadog/configuration/{alias}' \
  --header 'Authorization: Bearer JWT'

200

400

404

429

200

{
  "alias": "text",
  "customSubdomain": "text",
  "environments": [
    "text"
  ],
  "isDefault": true,
  "lastFourApiKey": "text",
  "lastFourAppKey": "text",
  "region": "EU1"
}

Successfully found configuration

Add multiple configurations

post

Authorizations

Body

configurationsobject[]required

Responses

application/json

application/json

application/problem+json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.getcortexapp.com/api/v1/datadog/configurations' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "configurations": [
      {
        "alias": "text",
        "apiKey": "text",
        "appKey": "text",
        "customSubdomain": "text",
        "environments": [
          "text"
        ],
        "isDefault": true,
        "region": "EU1"
      }
    ]
  }'

200

403

429

200

{
  "configurations": [
    {
      "alias": "text",
      "customSubdomain": "text",
      "environments": [
        "text"
      ],
      "isDefault": true,
      "lastFourApiKey": "text",
      "lastFourAppKey": "text",
      "region": "EU1"
    }
  ],
  "skippedConfigurations": {
    "ANY_ADDITIONAL_PROPERTY": "text"
  }
}

Successfully added configurations

Add a single configuration

post

Authorizations

Body

aliasstringrequired

apiKeystringrequired

appKeystringrequired

customSubdomainstringoptional

environmentsstring[]required

isDefaultbooleanrequired

regionstring · enumrequired

Options: EU1, US1, US3, US5, US1_FED

Responses

application/json

application/json

application/json

application/problem+json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.getcortexapp.com/api/v1/datadog/configuration' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "alias": "text",
    "apiKey": "text",
    "appKey": "text",
    "customSubdomain": "text",
    "environments": [
      "text"
    ],
    "isDefault": true,
    "region": "EU1"
  }'

200

400

403

429

200

{
  "configurations": [
    {
      "alias": "text",
      "customSubdomain": "text",
      "environments": [
        "text"
      ],
      "isDefault": true,
      "lastFourApiKey": "text",
      "lastFourAppKey": "text",
      "region": "EU1"
    }
  ]
}

Successfully added configuration

Validate all configurations

post

Authorizations

Responses

application/json

application/json

application/problem+json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.getcortexapp.com/api/v1/datadog/configuration/validate' \
  --header 'Authorization: Bearer JWT'

200

404

429

200

{
  "configurations": [
    {
      "alias": "text",
      "isValid": true,
      "message": "text"
    }
  ]
}

Successfully validated all configurations

Validate a configuration

post

Authorizations

Path parameters

aliasstringrequired

Responses

application/json

application/json

application/problem+json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.getcortexapp.com/api/v1/datadog/configuration/validate/{alias}' \
  --header 'Authorization: Bearer JWT'

200

404

429

200

{
  "alias": "text",
  "isValid": true,
  "message": "text"
}

Successfully validated configuration

Update a configuration

put

WARNING: Updating aliases for configurations or changing the default configuration could cause entity YAMLs that use this integration to break.

Authorizations

Path parameters

aliasstringrequired

Body

aliasstringrequired

environmentsstring[]required

isDefaultbooleanrequired

Responses

application/json

application/json

application/json

application/json

application/problem+json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://api.getcortexapp.com/api/v1/datadog/configuration/{alias}' \
  --header 'Authorization: Bearer JWT' \
  --header 'Content-Type: application/json' \
  --data '{
    "alias": "text",
    "environments": [
      "text"
    ],
    "isDefault": true
  }'

200

400

403

404

429

200

{
  "configurations": [
    {
      "alias": "text",
      "customSubdomain": "text",
      "environments": [
        "text"
      ],
      "isDefault": true,
      "lastFourApiKey": "text",
      "lastFourAppKey": "text",
      "region": "EU1"
    }
  ]
}

Successfully updated configuration

Delete a configuration

delete

Authorizations

Path parameters

aliasstringrequired

Responses

application/json

application/json

application/json

application/json

application/problem+json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://api.getcortexapp.com/api/v1/datadog/configuration/{alias}' \
  --header 'Authorization: Bearer JWT'

200

400

403

404

429

200

{
  "configurations": [
    {
      "alias": "text",
      "customSubdomain": "text",
      "environments": [
        "text"
      ],
      "isDefault": true,
      "lastFourApiKey": "text",
      "lastFourAppKey": "text",
      "region": "EU1"
    }
  ]
}

Successfully deleted configuration

Delete all configurations

delete

Authorizations

Responses

application/json

application/json

application/problem+json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://api.getcortexapp.com/api/v1/datadog/configurations' \
  --header 'Authorization: Bearer JWT'

200

400

403

429

200

No body

Successfully deleted all configurations