Create an incident impact field
WARNINGNote: This endpoint is in preview and is subject to change.
If you have any feedback, contact Datadog support.
POST
https://api.datadoghq.com/api/v2/incidents/config/impact-fieldshttps://api.us3.datadoghq.com/api/v2/incidents/config/impact-fieldshttps://api.us5.datadoghq.com/api/v2/incidents/config/impact-fieldshttps://api.datadoghq.eu/api/v2/incidents/config/impact-fieldshttps://api.ap1.datadoghq.com/api/v2/incidents/config/impact-fieldshttps://api.ap2.datadoghq.com/api/v2/incidents/config/impact-fieldshttps://api.uk1.datadoghq.com/api/v2/incidents/config/impact-fieldshttps://api.ddog-gov.com/api/v2/incidents/config/impact-fieldshttps://api.us2.ddog-gov.com/api/v2/incidents/config/impact-fieldsOverview
Create an impact field for incidents.
OAuth apps require the incident_settings_write authorization scope to access this endpoint.
Request
Body Data (required)
Impact field payload.
Field
Type
Description
data [required]object
Impact field data in a create request.
attributes [required]object
Attributes for creating an impact field.
display_name [required]string
The display name of the impact field.
field_choices[object]
The choices for dropdown or multiselect fields.
descriptionstring
The description of the choice.
display_name [required]string
The display name of the choice.
value [required]string
The value of the choice.
field_type [required]enum
The type of an impact field.
Allowed enum values:
dropdown, text, textarray, metrictag, number, datetime, multiselectname [required]string
The normalized name of the impact field (used as identifier).
tag_keystring
The tag key associated with the field (for metrictag type).
relationships [required]object
Relationships for an impact field create request.
incident_type [required]object
Relationship to an incident type.
data [required]object
Relationship to incident type object.
id [required]string
The incident type's ID.
type [required]enum
Incident type resource type.
incident_typesAllowed enum values:
incident_typestype [required]enum
Impact field resource type.
Allowed enum values:
impact_fields{
"data": {
"attributes": {
"display_name": "Customer Impact Scope",
"field_choices": [
{
"description": "Affects all customers",
"display_name": "All Customers",
"value": "all_customers"
},
{
"description": "Affects some customers",
"display_name": "Some Customers",
"value": "some_customers"
}
],
"field_type": "dropdown",
"name": "customer_impact_scope"
},
"relationships": {
"incident_type": {
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"type": "incident_types"
}
}
},
"type": "impact_fields"
}
}Response
Created
Response with a single impact field.
Field
Type
Description
data [required]object
Impact field data in a response.
attributes [required]object
Attributes of an impact field in a response.
display_name [required]string
The display name of the impact field.
field_choices[object]
The choices for dropdown or multiselect fields.
descriptionstring
The description of the choice.
display_name [required]string
The display name of the choice.
value [required]string
The value of the choice.
field_type [required]enum
The type of an impact field.
Allowed enum values:
dropdown, text, textarray, metrictag, number, datetime, multiselectname [required]string
The normalized name of the impact field.
tag_keystring
The tag key associated with the field.
id [required]uuid
The impact field identifier.
relationshipsobject
Relationships for an impact field.
created_by_userobject
Relationship to user.
data [required]object
Relationship to user object.
id [required]string
A unique identifier that represents the user.
type [required]enum
Users resource type.
usersAllowed enum values:
usersincident_typeobject
Relationship to an incident type.
data [required]object
Relationship to incident type object.
id [required]string
The incident type's ID.
type [required]enum
Incident type resource type.
incident_typesAllowed enum values:
incident_typeslast_modified_by_userobject
Relationship to user.
data [required]object
Relationship to user object.
id [required]string
A unique identifier that represents the user.
type [required]enum
Users resource type.
usersAllowed enum values:
userstype [required]enum
Impact field resource type.
Allowed enum values:
impact_fieldsincluded[object]
Included related resources.
attributesobject
Attributes of user object returned by the API.
emailstring
Email of the user.
handlestring
Handle of the user.
iconstring
URL of the user's icon.
namestring
Name of the user.
uuidstring
UUID of the user.
idstring
ID of the user.
typeenum
Users resource type.
usersAllowed enum values:
users{
"data": {
"attributes": {
"display_name": "Customer Impact Scope",
"field_choices": [
{
"description": "Affects all customers",
"display_name": "Critical",
"value": "critical"
}
],
"field_type": "dropdown",
"name": "customer_impact_scope",
"tag_key": "env"
},
"id": "00000000-0000-0000-0000-000000000000",
"relationships": {
"created_by_user": {
"data": {
"id": "00000000-0000-0000-2345-000000000000",
"type": "users"
}
},
"incident_type": {
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"type": "incident_types"
}
},
"last_modified_by_user": {
"data": {
"id": "00000000-0000-0000-2345-000000000000",
"type": "users"
}
}
},
"type": "impact_fields"
},
"included": [
{
"attributes": {
"email": "string",
"handle": "string",
"icon": "string",
"name": "string",
"uuid": "string"
},
"id": "string",
"type": "users"
}
]
}Bad Request
API error response.
Field
Type
Description
errors [required][string]
A list of errors.
{
"errors": [
"Bad Request"
]
}Unauthorized
API error response.
Field
Type
Description
errors [required][string]
A list of errors.
{
"errors": [
"Bad Request"
]
}Forbidden
API error response.
Field
Type
Description
errors [required][string]
A list of errors.
{
"errors": [
"Bad Request"
]
}Too many requests
API error response.
Field
Type
Description
errors [required][string]
A list of errors.
{
"errors": [
"Bad Request"
]
}Code Example
# 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 POST "https://api.${DD_SITE}/api/v2/incidents/config/impact-fields" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"display_name": "Customer Impact Scope",
"field_choices": [
{
"description": "Affects all customers",
"display_name": "All Customers",
"value": "all_customers"
},
{
"description": "Affects some customers",
"display_name": "Some Customers",
"value": "some_customers"
}
],
"field_type": "dropdown",
"name": "customer_impact_scope"
},
"relationships": {
"incident_type": {
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"type": "incident_types"
}
}
},
"type": "impact_fields"
}
}
EOF# 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 POST "https://api.${DD_SITE}/api/v2/incidents/config/impact-fields" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"display_name": "Customer Impact Scope",
"field_choices": [
{
"description": "Affects all customers",
"display_name": "All Customers",
"value": "all_customers"
},
{
"description": "Affects some customers",
"display_name": "Some Customers",
"value": "some_customers"
}
],
"field_type": "dropdown",
"name": "customer_impact_scope"
},
"relationships": {
"incident_type": {
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"type": "incident_types"
}
}
},
"type": "impact_fields"
}
}
EOF# 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 POST "https://api.${DD_SITE}/api/v2/incidents/config/impact-fields" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"display_name": "Customer Impact Scope",
"field_choices": [
{
"description": "Affects all customers",
"display_name": "All Customers",
"value": "all_customers"
},
{
"description": "Affects some customers",
"display_name": "Some Customers",
"value": "some_customers"
}
],
"field_type": "dropdown",
"name": "customer_impact_scope"
},
"relationships": {
"incident_type": {
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"type": "incident_types"
}
}
},
"type": "impact_fields"
}
}
EOF# 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 POST "https://api.${DD_SITE}/api/v2/incidents/config/impact-fields" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"display_name": "Customer Impact Scope",
"field_choices": [
{
"description": "Affects all customers",
"display_name": "All Customers",
"value": "all_customers"
},
{
"description": "Affects some customers",
"display_name": "Some Customers",
"value": "some_customers"
}
],
"field_type": "dropdown",
"name": "customer_impact_scope"
},
"relationships": {
"incident_type": {
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"type": "incident_types"
}
}
},
"type": "impact_fields"
}
}
EOF# 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 POST "https://api.${DD_SITE}/api/v2/incidents/config/impact-fields" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"display_name": "Customer Impact Scope",
"field_choices": [
{
"description": "Affects all customers",
"display_name": "All Customers",
"value": "all_customers"
},
{
"description": "Affects some customers",
"display_name": "Some Customers",
"value": "some_customers"
}
],
"field_type": "dropdown",
"name": "customer_impact_scope"
},
"relationships": {
"incident_type": {
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"type": "incident_types"
}
}
},
"type": "impact_fields"
}
}
EOF# 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 POST "https://api.${DD_SITE}/api/v2/incidents/config/impact-fields" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"display_name": "Customer Impact Scope",
"field_choices": [
{
"description": "Affects all customers",
"display_name": "All Customers",
"value": "all_customers"
},
{
"description": "Affects some customers",
"display_name": "Some Customers",
"value": "some_customers"
}
],
"field_type": "dropdown",
"name": "customer_impact_scope"
},
"relationships": {
"incident_type": {
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"type": "incident_types"
}
}
},
"type": "impact_fields"
}
}
EOF# 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 POST "https://api.${DD_SITE}/api/v2/incidents/config/impact-fields" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"display_name": "Customer Impact Scope",
"field_choices": [
{
"description": "Affects all customers",
"display_name": "All Customers",
"value": "all_customers"
},
{
"description": "Affects some customers",
"display_name": "Some Customers",
"value": "some_customers"
}
],
"field_type": "dropdown",
"name": "customer_impact_scope"
},
"relationships": {
"incident_type": {
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"type": "incident_types"
}
}
},
"type": "impact_fields"
}
}
EOF# 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 POST "https://api.${DD_SITE}/api/v2/incidents/config/impact-fields" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"display_name": "Customer Impact Scope",
"field_choices": [
{
"description": "Affects all customers",
"display_name": "All Customers",
"value": "all_customers"
},
{
"description": "Affects some customers",
"display_name": "Some Customers",
"value": "some_customers"
}
],
"field_type": "dropdown",
"name": "customer_impact_scope"
},
"relationships": {
"incident_type": {
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"type": "incident_types"
}
}
},
"type": "impact_fields"
}
}
EOF# 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 POST "https://api.${DD_SITE}/api/v2/incidents/config/impact-fields" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ${DD_BEARER_TOKEN}" \
-d @- << EOF
{
"data": {
"attributes": {
"display_name": "Customer Impact Scope",
"field_choices": [
{
"description": "Affects all customers",
"display_name": "All Customers",
"value": "all_customers"
},
{
"description": "Affects some customers",
"display_name": "Some Customers",
"value": "some_customers"
}
],
"field_type": "dropdown",
"name": "customer_impact_scope"
},
"relationships": {
"incident_type": {
"data": {
"id": "00000000-0000-0000-0000-000000000000",
"type": "incident_types"
}
}
},
"type": "impact_fields"
}
}
EOF