Datadog Incident API
The Incident API from Datadog — 14 operation(s) for incident.
Datadog Incident API is one of 290 APIs that Datadog publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
This API exposes 4 JSON Schema definitions.
Tagged areas include Incident. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, an API reference, and 4 JSON Schemas.
This API exposes 29 operations across 14 paths, and defines 160 schemas. It is described by OpenAPI 3.0.0, at version 1.0.
Requests are made against 3 base URLs: https://{subdomain}.{site}, {protocol}://{name}, https://{subdomain}.{site}.
29 operations
14 paths
160 schemas
6 DELETE9 GET7 PATCH7 POST
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 4
Datadog Incident API declares
4 security schemes
for authenticating requests.
It supports OAuth 2.0 (AuthZ) using the authorizationCode flow, exposing 68 scopes.
An API key is passed in the header as DD-API-KEY (apiKeyAuth).
An API key is passed in the header as DD-APPLICATION-KEY (appKeyAuth).
It accepts HTTP bearer tokens (bearerAuth).
By default, every request must be authenticated.
AuthZ— This API uses OAuth 2 with the implicit grant flow.apiKeyAuth— Your Datadog API Key.appKeyAuth— Your Datadog APP Key.
Paths & Operations 29
Across 14 paths, the API surfaces 29 operations — 6 DELETE, 9 GET, 7 PATCH, 7 POST. Each is listed below with its method, path, parameters, and response codes.
Incident 29
POST
/api/v2/dora/incident
Datadog Send an Incident Event for Dora Metrics
POST
/api/v2/incidents
Datadog Create an Incident
GET
/api/v2/incidents/config/types
Datadog Get a List of Incident Types
POST
/api/v2/incidents/config/types
Datadog Create an Incident Type
DELETE
/api/v2/incidents/config/types/{incident_type_id}
Datadog Delete an Incident Type
GET
/api/v2/incidents/config/types/{incident_type_id}
Datadog Get Incident Type Details
PATCH
/api/v2/incidents/config/types/{incident_type_id}
Datadog Update an Incident Type
DELETE
/api/v2/incidents/{incident_id}
Datadog Delete an Existing Incident
GET
/api/v2/incidents/{incident_id}
Datadog Get the Details of an Incident
PATCH
/api/v2/incidents/{incident_id}
Datadog Update an Existing Incident
PATCH
/api/v2/incidents/{incident_id}/attachments
Datadog Create, Update, and Delete Incident Attachments
POST
/api/v2/incidents/{incident_id}/relationships/integrations
Datadog Create an Incident Integration Metadata
DELETE
/api/v2/incidents/{incident_id}/relationships/integrations/{integration_metadata_id}
Datadog Delete an Incident Integration Metadata
GET
/api/v2/incidents/{incident_id}/relationships/integrations/{integration_metadata_id}
Datadog Get Incident Integration Metadata Details
PATCH
/api/v2/incidents/{incident_id}/relationships/integrations/{integration_metadata_id}
Datadog Update an Existing Incident Integration Metadata
POST
/api/v2/incidents/{incident_id}/relationships/todos
Datadog Create an Incident Todo
DELETE
/api/v2/incidents/{incident_id}/relationships/todos/{todo_id}
Datadog Delete an Incident Todo
GET
/api/v2/incidents/{incident_id}/relationships/todos/{todo_id}
Datadog Get Incident Todo Details
PATCH
/api/v2/incidents/{incident_id}/relationships/todos/{todo_id}
Datadog Update an Incident Todo
GET
/api/v2/servicesdeprecated
Datadog Get a List of All Incident Services
POST
/api/v2/servicesdeprecated
Datadog Create a New Incident Service
DELETE
/api/v2/services/{service_id}deprecated
Datadog Delete an Existing Incident Service
GET
/api/v2/services/{service_id}deprecated
Datadog Get Details of an Incident Service
PATCH
/api/v2/services/{service_id}deprecated
Datadog Update an Existing Incident Service
GET
/api/v2/teamsdeprecated
Datadog Get a List of All Incident Teams
POST
/api/v2/teamsdeprecated
Datadog Create a New Incident Team
DELETE
/api/v2/teams/{team_id}deprecated
Datadog Delete an Existing Incident Team
GET
/api/v2/teams/{team_id}deprecated
Datadog Get Details of an Incident Team
PATCH
/api/v2/teams/{team_id}deprecated
Datadog Update an Existing Incident Team
Schemas 160
The contract defines 160 schemas that model the data the API accepts and returns. The most detailed are IncidentResponseAttributes (24 properties), UserAttributes (12 properties), DORAIncidentRequestAttributes (10 properties), IncidentTypeUpdateAttributes (8 properties). Each schema is shown below with its type and property counts.
GitCommitSHA
string
Git Commit SHA.
UsersType
string
Users resource type.
IncidentAttachmentAttributes
The attributes object for an attachment.
IncidentAttachmentRelatedObject
string
The object related to an incident attachment.
JSONAPIErrorItem
object
API error response body
5 properties
IncidentIntegrationRelationships
object
The incident's integration relationships from a response.
2 properties
IncidentTypeListResponse
object
Response with a list of incident types.
1 property
1 required
IncidentTodoResponseIncludedItem
An object related to an incident todo that is included in the response.
IncidentServiceCreateData
object
Incident Service payload for create requests.
3 properties
1 required
RelationshipToIncidentPostmortemData
object
The postmortem relationship data.
2 properties
2 required
RelationshipToIncidentUserDefinedFields
object
Relationship to incident user defined fields.
1 property
1 required
IncidentResponseRelationships
object
The incident's relationships from a response.
8 properties
UserAttributes
object
Attributes of user object returned by the API.
12 properties
IncidentPostmortemType
string
Incident postmortem resource type.
DORAGitInfo
object
Git info for DORA Metrics events.
2 properties
2 required
IncidentType
string
Incident resource type.
IncidentIntegrationMetadataType
string
Integration metadata resource type.
IncidentTeamUpdateAttributes
object
The incident team's attributes for an update request.
1 property
1 required
IncidentTodoPatchData
object
Incident todo data for a patch request.
2 properties
2 required
IncidentAttachmentRelationships
object
The incident attachment's relationships.
1 property
IncidentTodoAnonymousAssigneeSource
string
The source of the anonymous assignee.
IncidentServicesResponse
object
Response with a list of incident service payloads.
3 properties
1 required
JSONAPIErrorResponse
object
API error response.
1 property
1 required
IncidentIntegrationMetadataResponseData
object
Incident integration metadata from a response.
4 properties
2 required
IncidentAttachmentType
string
The incident attachment resource type.
IncidentUserAttributes
object
Attributes of user object returned by the API.
5 properties
DORAIncidentRequest
object
Request to create a DORA incident event.
1 property
1 required
IncidentNotificationHandle
object
A notification handle that will be notified at incident creation.
2 properties
DORAIncidentRequestAttributes
object
Attributes to create a DORA incident event.
10 properties
1 required
JiraIntegrationMetadataIssuesItem
object
Item in the Jira integration metadata issue array.
5 properties
2 required
SlackIntegrationMetadata
object
Incident integration metadata for the Slack integration.
1 property
1 required
RelationshipToIncidentResponderData
object
Relationship to impact object.
2 properties
2 required
RelationshipToIncidentImpacts
object
Relationship to impacts.
1 property
1 required
IncidentServiceUpdateData
object
Incident Service payload for update requests.
4 properties
1 required
IncidentUpdateData
object
Incident data for an update request.
4 properties
2 required
DORAIncidentResponseData
object
Response after receiving a DORA incident event.
2 properties
1 required
User
object
User object returned by the API.
4 properties
IncidentIntegrationMetadataResponseIncludedItem
An object related to an incident integration metadata that is included in the response.
IncidentTodoResponseData
object
Incident todo response data.
4 properties
2 required
IncidentIntegrationMetadataCreateRequest
object
Create request for an incident integration metadata.
1 property
1 required
IncidentAttachmentPostmortemAttributes
object
The attributes object for a postmortem attachment.
2 properties
2 required
RelationshipToUser
object
Relationship to user.
1 property
1 required
IncidentTodoCreateData
object
Incident todo data for a create request.
2 properties
2 required
RelationshipToIncidentAttachment
object
A relationship reference for attachments.
1 property
1 required
IncidentAttachmentUpdateRequest
object
The update request for an incident's attachments.
1 property
1 required
RelationshipToIncidentIntegrationMetadataData
object
A relationship reference for an integration metadata object.
2 properties
2 required
RelationshipToOrganization
object
Relationship to an organization.
1 property
1 required
IncidentFieldAttributesValueType
string
Type of the multiple value field definitions.
IncidentTeamCreateRequest
object
Create request with an incident team payload.
1 property
1 required
RelationshipToIncidentIntegrationMetadatas
object
A relationship reference for multiple integration metadata objects.
1 property
1 required
IncidentServiceRelationships
object
The incident service's relationships.
2 properties
IncidentFieldAttributesSingleValueType
string
Type of the single value field definitions.
IncidentTeamResponseAttributes
object
The incident team's attributes from a response.
3 properties
IncidentServiceUpdateRequest
object
Update request with an incident service payload.
1 property
1 required
RelationshipToUserData
object
Relationship to user object.
2 properties
2 required
IncidentIntegrationMetadataPatchData
object
Incident integration metadata data for a patch request.
2 properties
2 required
IncidentTypeObject
object
Incident type response data.
3 properties
2 required
IncidentAttachmentLinkAttachmentType
string
The type of link attachment attributes.
IncidentResponseMetaPagination
object
Pagination properties.
3 properties
IncidentTodoAssignee
A todo assignee.
IncidentTodoAssigneeArray
array
Array of todo assignees.
IncidentTodoRelationships
object
The incident's relationships from a response.
2 properties
IncidentAttachmentLinkAttributes
object
The attributes object for a link attachment.
3 properties
2 required
IncidentServiceCreateAttributes
object
The incident service's attributes for a create request.
1 property
1 required
IncidentCreateRequest
object
Create request for an incident.
1 property
1 required
JiraIntegrationMetadata
object
Incident integration metadata for the Jira integration.
1 property
1 required
IncidentTeamIncludedItems
An object related to an incident team which is present in the included payload.
IncidentResponseMeta
object
The metadata object containing pagination metadata.
1 property
IncidentUserData
object
User object returned by the API.
3 properties
IncidentResponseData
object
Incident data from a response.
4 properties
2 required
JSONAPIErrorItemSource
object
References to the source of the error.
3 properties
RelationshipToIncidentUserDefinedFieldData
object
Relationship to impact object.
2 properties
2 required
IncidentServiceType
string
Incident service resource type.
IncidentTypeAttributes
object
Incident type's attributes.
8 properties
1 required
IncidentUpdateRequest
object
Update request for an incident.
1 property
1 required
MSTeamsIntegrationMetadata
object
Incident integration metadata for the Microsoft Teams integration.
1 property
1 required
IncidentCreateAttributes
object
The incident's attributes for a create request.
7 properties
2 required
IncidentCreateData
object
Incident data for a create request.
3 properties
2 required
IncidentUserDefinedFieldType
string
The incident user defined fields type.
IncidentTypeResponse
object
Incident type response data.
1 property
1 required
IncidentAttachmentLinkAttributesAttachmentObject
object
The link attachment.
2 properties
2 required
IncidentTodoCreateRequest
object
Create request for an incident todo.
1 property
1 required
IncidentTeamsResponse
object
Response with a list of incident team payloads.
3 properties
1 required
IncidentFieldAttributesSingleValue
object
A field with a single value selected.
2 properties
DORAIncidentType
string
JSON:API type for DORA incident events.
IncidentResponse
object
Response with an incident.
2 properties
1 required
OrganizationsType
string
Organizations resource type.
RelationshipToIncidentPostmortem
object
A relationship reference for postmortems.
1 property
1 required
IncidentTimelineCellMarkdownCreateAttributes
object
Timeline cell data for Markdown timeline cells for a create request.
3 properties
2 required
IncidentServiceUpdateAttributes
object
The incident service's attributes for an update request.
1 property
1 required
IncidentCreateRelationships
object
The relationships the incident will have with other resources once created.
1 property
1 required
IncidentTodoResponse
object
Response with an incident todo.
2 properties
1 required
IncidentIntegrationMetadataMetadata
Incident integration metadata's metadata attribute.
RelationshipToIncidentResponders
object
Relationship to incident responders.
1 property
1 required
APIErrorResponse
object
API error response.
1 property
1 required
IncidentAttachmentUpdateData
object
A single incident attachment.
3 properties
1 required
UserResponseRelationships
object
Relationships of the user object returned by the API.
4 properties
IncidentTimelineCellCreateAttributes
The timeline cell's attributes for a create request.
IncidentFieldAttributesMultipleValue
object
A field with potentially multiple values selected.
2 properties
IncidentIntegrationMetadataCreateData
object
Incident integration metadata data for a create request.
2 properties
2 required
MSTeamsIntegrationMetadataTeamsItem
object
Item in the Microsoft Teams integration metadata teams array.
4 properties
4 required
IncidentTeamUpdateRequest
object
Update request with an incident team payload.
1 property
1 required
IncidentTodoPatchRequest
object
Patch request for an incident todo.
1 property
1 required
IncidentTodoAttributes
object
Incident todo's attributes.
7 properties
2 required
DORAIncidentRequestData
object
The JSON:API data.
1 property
1 required
IncidentUpdateAttributes
object
The incident's attributes for an update request.
8 properties
IncidentTypePatchData
object
Incident type data for a patch request.
3 properties
3 required
IncidentTeamResponse
object
Response with an incident team payload.
2 properties
1 required
IncidentResponseAttributes
object
The incident's attributes from a response.
24 properties
1 required
IncidentResponseIncludedItem
An object related to an incident that is included in the response.
IncidentTeamUpdateData
object
Incident Team data for an update request.
4 properties
1 required
IncidentRespondersType
string
The incident responders type.
IncidentServiceResponseAttributes
object
The incident service's attributes from a response.
3 properties
IncidentImpactsType
string
The incident impacts type.
RelationshipToRoleData
object
Relationship to role object.
2 properties
RelationshipToIncidentAttachmentData
object
The attachment relationship data.
2 properties
2 required
GitRepositoryURL
string
Git Repository URL
SlackIntegrationMetadataChannelItem
object
Item in the Slack integration metadata channel array.
4 properties
3 required
RelationshipToOrganizationData
object
Relationship to organization object.
2 properties
2 required
RelationshipToIncidentImpactData
object
Relationship to impact object.
2 properties
2 required
IncidentTeamResponseData
object
Incident Team data from a response.
4 properties
IncidentTimelineCellMarkdownCreateAttributesContent
object
The Markdown timeline cell contents.
1 property
IncidentAttachmentUpdateResponse
object
The response object containing the created or updated incident attachments.
2 properties
1 required
RelationshipToUsers
object
Relationship to users.
1 property
1 required
IncidentFieldAttributes
Dynamic fields for which selections can be made, with field names as keys.
IncidentNonDatadogCreator
object
Incident's non Datadog creator.
2 properties
NullableRelationshipToUserData
object
Relationship to user object.
2 properties
2 required
IncidentServiceIncludedItems
An object related to an incident service which is present in the included payload.
IncidentTypeCreateData
object
Incident type data for a create request.
2 properties
2 required
IncidentTeamCreateData
object
Incident Team data for a create request.
3 properties
1 required
IncidentUpdateRelationships
object
The incident's relationships for an update request.
3 properties
IncidentTodoAssigneeHandle
string
Assignee's @-handle.
IncidentTodoAnonymousAssignee
object
Anonymous assignee entity.
4 properties
4 required
RelationshipToRoles
object
Relationship to roles.
1 property
RelationshipToOrganizations
object
Relationship to organizations.
1 property
1 required
IncidentServiceResponse
object
Response with an incident service payload.
2 properties
1 required
IncidentIntegrationMetadataResponse
object
Response with an incident integration metadata.
2 properties
1 required
IncidentTeamCreateAttributes
object
The incident team's attributes for a create request.
1 property
1 required
IncidentAttachmentUpdateAttributes
Incident attachment attributes.
IncidentTodoType
string
Todo resource type.
NullableRelationshipToUser
object
Relationship to user.
1 property
1 required
IncidentAttachmentsPostmortemAttributesAttachmentObject
object
The postmortem attachment.
2 properties
2 required
IncidentTypeType
string
Incident type resource type.
IncidentAttachmentData
object
A single incident attachment.
4 properties
4 required
DORAIncidentResponse
object
Response after receiving a DORA incident event.
1 property
1 required
IncidentAttachmentPostmortemAttachmentType
string
The type of postmortem attachment attributes.
IncidentAttachmentsResponseIncludedItem
An object related to an attachment that is included in the response.
IncidentTypeCreateRequest
object
Create request for an incident type.
1 property
1 required
IncidentIntegrationMetadataAttributes
object
Incident integration metadata's attributes for a create request.
6 properties
2 required
IncidentSeverity
string
The incident severity.
IncidentTypePatchRequest
object
Patch request for an incident type.
1 property
1 required
IncidentServiceResponseData
object
Incident Service data from responses.
4 properties
2 required
IncidentRelatedObject
string
Object related to an incident.
RolesType
string
Roles type.
IncidentTimelineCellMarkdownContentType
string
Type of the Markdown timeline cell.
IncidentTypeUpdateAttributes
object
Incident type's attributes for updates.
8 properties
IncidentServiceCreateRequest
object
Create request with an incident service payload.
1 property
1 required
IncidentTeamType
string
Incident Team resource type.
IncidentTeamRelationships
object
The incident team's relationships.
2 properties
IncidentIntegrationMetadataPatchRequest
object
Patch request for an incident integration metadata.
1 property
1 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Datadog 12
Other APIs Datadog publishes across the network.
Datadog Dashboards API
Datadog Synthetics API
Datadog Service Level Objectives API
Datadog Security Monitoring API
Datadog Service Definition API
Datadog Software Catalog API
Datadog Users API
Datadog Roles API
Datadog Key Management API
Datadog Organizations API
Datadog Downtimes API
Datadog RUM API
#Incident
Where this information came from
This is an independent, third-party profile of Datadog Incident API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.