Create or replace the configuration for a given integration in the caller’s organization. The shape of data.attributes.config depends on the integration:
For github: config must contain an enabled_repos array of objects with hostname, github_org_name, and repo_name.
For jira: config must contain an enabled_projects array of objects with hostname, account_id, and project_key.
For pagerduty: config must contain an accounts array of objects with a required enabled boolean and an optional subdomain string.
This endpoint requires the integrations_read permission.
Arguments
Path Parameters
Name
Type
Description
integration_id [required]
string
The identifier of the integration whose configuration is being managed. Supported values are github, jira, and pagerduty.
JSON:API resource object used in a request to create or update an entity integration configuration.
attributes [required]
object
Attributes used to create or update an entity integration configuration.
config [required]
object
Integration-specific configuration payload. The shape of this object depends on the integration identified by the path parameter. For github, the object must contain an enabled_repos array. For jira, it must contain an enabled_projects array. For pagerduty, it must contain an accounts array.
type [required]
enum
JSON:API resource type for the entity integration configuration create or update request. Always entity_integration_config_requests.
Allowed enum values: entity_integration_config_requests
JSON:API resource object for an entity integration configuration.
attributes [required]
object
The organization ID, integration identifier, and integration-specific configuration payload for an entity integration configuration.
config [required]
object
Integration-specific configuration payload. The shape of this object depends on the integration identified by the path parameter. For github, the object must contain an enabled_repos array. For jira, it must contain an enabled_projects array. For pagerduty, it must contain an accounts array.
integration_id [required]
string
The identifier of the integration this configuration applies to (for example, github, jira, or pagerduty).
org_id [required]
int64
The Datadog organization identifier that owns this configuration.
id [required]
string
Unique identifier of the entity integration configuration.
type [required]
enum
JSON:API resource type for an entity integration configuration. Always entity_integration_configs.
Allowed enum values: entity_integration_configs
JSON:API document containing a single entity integration configuration resource.
Expand All
Field
Type
Description
data [required]
object
JSON:API resource object for an entity integration configuration.
attributes [required]
object
The organization ID, integration identifier, and integration-specific configuration payload for an entity integration configuration.
config [required]
object
Integration-specific configuration payload. The shape of this object depends on the integration identified by the path parameter. For github, the object must contain an enabled_repos array. For jira, it must contain an enabled_projects array. For pagerduty, it must contain an accounts array.
integration_id [required]
string
The identifier of the integration this configuration applies to (for example, github, jira, or pagerduty).
org_id [required]
int64
The Datadog organization identifier that owns this configuration.
id [required]
string
Unique identifier of the entity integration configuration.
type [required]
enum
JSON:API resource type for an entity integration configuration. Always entity_integration_configs.
Allowed enum values: entity_integration_configs
