@@ -467,6 +467,24 @@ components:
467467 required: true
468468 schema:
469469 type: string
470+ IncidentImpactIDPathParameter:
471+ description: The UUID of the incident impact.
472+ in: path
473+ name: impact_id
474+ required: true
475+ schema:
476+ format: uuid
477+ type: string
478+ IncidentImpactIncludeQueryParameter:
479+ description: Specifies which related resources should be included in the response.
480+ explode: false
481+ in: query
482+ name: include
483+ required: false
484+ schema:
485+ items:
486+ $ref: '#/components/schemas/IncidentImpactRelatedObject'
487+ type: array
470488 IncidentIncludeQueryParameter:
471489 description: Specifies which types of related objects should be included in
472490 the response.
@@ -20120,6 +20138,171 @@ components:
2012020138 - TEXTARRAY
2012120139 - METRICTAG
2012220140 - AUTOCOMPLETE
20141+ IncidentImpactAttributes:
20142+ description: The incident impact's attributes.
20143+ properties:
20144+ created:
20145+ description: Timestamp when the impact was created.
20146+ example: '2025-08-29T13:17:00Z'
20147+ format: date-time
20148+ readOnly: true
20149+ type: string
20150+ description:
20151+ description: Description of the impact.
20152+ example: Service was unavailable for external users
20153+ type: string
20154+ end_at:
20155+ description: Timestamp when the impact ended.
20156+ example: '2025-08-29T13:17:00Z'
20157+ format: date-time
20158+ nullable: true
20159+ type: string
20160+ fields:
20161+ $ref: '#/components/schemas/IncidentImpactFields'
20162+ modified:
20163+ description: Timestamp when the impact was last modified.
20164+ example: '2025-08-29T13:17:00Z'
20165+ format: date-time
20166+ readOnly: true
20167+ type: string
20168+ start_at:
20169+ description: Timestamp representing when the impact started.
20170+ example: '2025-08-28T13:17:00Z'
20171+ format: date-time
20172+ type: string
20173+ required:
20174+ - description
20175+ - start_at
20176+ type: object
20177+ IncidentImpactCreateAttributes:
20178+ description: The incident impact's attributes for a create request.
20179+ properties:
20180+ description:
20181+ description: Description of the impact.
20182+ example: Service was unavailable for external users
20183+ type: string
20184+ end_at:
20185+ description: Timestamp when the impact ended.
20186+ example: '2025-08-29T13:17:00Z'
20187+ format: date-time
20188+ nullable: true
20189+ type: string
20190+ fields:
20191+ $ref: '#/components/schemas/IncidentImpactFields'
20192+ start_at:
20193+ description: Timestamp when the impact started.
20194+ example: '2025-08-28T13:17:00Z'
20195+ format: date-time
20196+ type: string
20197+ required:
20198+ - description
20199+ - start_at
20200+ type: object
20201+ IncidentImpactCreateData:
20202+ description: Incident impact data for a create request.
20203+ properties:
20204+ attributes:
20205+ $ref: '#/components/schemas/IncidentImpactCreateAttributes'
20206+ type:
20207+ $ref: '#/components/schemas/IncidentImpactType'
20208+ required:
20209+ - type
20210+ - attributes
20211+ type: object
20212+ IncidentImpactCreateRequest:
20213+ description: Create request for an incident impact.
20214+ properties:
20215+ data:
20216+ $ref: '#/components/schemas/IncidentImpactCreateData'
20217+ required:
20218+ - data
20219+ type: object
20220+ IncidentImpactFields:
20221+ description: An object mapping impact field names to field values.
20222+ example:
20223+ customers_impacted: all
20224+ products_impacted:
20225+ - shopping
20226+ - marketing
20227+ type: object
20228+ IncidentImpactRelatedObject:
20229+ description: A reference to a resource related to an incident impact.
20230+ enum:
20231+ - incident
20232+ - created_by_user
20233+ - last_modified_by_user
20234+ type: string
20235+ x-enum-varnames:
20236+ - INCIDENT
20237+ - CREATED_BY_USER
20238+ - LAST_MODIFIED_BY_USER
20239+ IncidentImpactRelationships:
20240+ description: The incident impact's resource relationships.
20241+ properties:
20242+ created_by_user:
20243+ $ref: '#/components/schemas/RelationshipToUser'
20244+ incident:
20245+ $ref: '#/components/schemas/RelationshipToIncident'
20246+ last_modified_by_user:
20247+ $ref: '#/components/schemas/RelationshipToUser'
20248+ type: object
20249+ IncidentImpactResponse:
20250+ description: Response with an incident impact.
20251+ properties:
20252+ data:
20253+ $ref: '#/components/schemas/IncidentImpactResponseData'
20254+ included:
20255+ description: Included related resources that the user requested.
20256+ items:
20257+ $ref: '#/components/schemas/IncidentUserData'
20258+ readOnly: true
20259+ type: array
20260+ required:
20261+ - data
20262+ type: object
20263+ IncidentImpactResponseData:
20264+ description: Incident impact data from a response.
20265+ properties:
20266+ attributes:
20267+ $ref: '#/components/schemas/IncidentImpactAttributes'
20268+ id:
20269+ description: The incident impact's ID.
20270+ example: 00000000-0000-0000-1234-000000000000
20271+ type: string
20272+ relationships:
20273+ $ref: '#/components/schemas/IncidentImpactRelationships'
20274+ type:
20275+ $ref: '#/components/schemas/IncidentImpactType'
20276+ required:
20277+ - id
20278+ - type
20279+ type: object
20280+ IncidentImpactType:
20281+ default: incident_impacts
20282+ description: Incident impact resource type.
20283+ enum:
20284+ - incident_impacts
20285+ example: incident_impacts
20286+ type: string
20287+ x-enum-varnames:
20288+ - INCIDENT_IMPACTS
20289+ IncidentImpactsResponse:
20290+ description: Response with a list of incident impacts.
20291+ properties:
20292+ data:
20293+ description: An array of incident impacts.
20294+ items:
20295+ $ref: '#/components/schemas/IncidentImpactResponseData'
20296+ type: array
20297+ included:
20298+ description: Included related resources that the user requested.
20299+ items:
20300+ $ref: '#/components/schemas/IncidentUserData'
20301+ readOnly: true
20302+ type: array
20303+ required:
20304+ - data
20305+ type: object
2012320306 IncidentImpactsType:
2012420307 description: The incident impacts type.
2012520308 enum:
@@ -20897,6 +21080,7 @@ components:
2089721080 - data
2089821081 type: object
2089921082 IncidentResponseAttributes:
21083+ additionalProperties: {}
2090021084 description: The incident's attributes from a response.
2090121085 properties:
2090221086 archived:
@@ -20941,6 +21125,17 @@ components:
2094121125 description: A flag indicating whether the incident caused customer impact.
2094221126 example: false
2094321127 type: boolean
21128+ declared:
21129+ description: Timestamp when the incident was declared.
21130+ format: date-time
21131+ readOnly: true
21132+ type: string
21133+ declared_by:
21134+ $ref: '#/components/schemas/IncidentNonDatadogCreator'
21135+ declared_by_uuid:
21136+ description: UUID of the user who declared the incident.
21137+ nullable: true
21138+ type: string
2094421139 detected:
2094521140 description: Timestamp when the incident was detected.
2094621141 format: date-time
@@ -21096,6 +21291,8 @@ components:
2109621291 $ref: '#/components/schemas/NullableRelationshipToUser'
2109721292 created_by_user:
2109821293 $ref: '#/components/schemas/RelationshipToUser'
21294+ declared_by_user:
21295+ $ref: '#/components/schemas/RelationshipToUser'
2109921296 impacts:
2110021297 $ref: '#/components/schemas/RelationshipToIncidentImpacts'
2110121298 integrations:
@@ -35408,6 +35605,14 @@ components:
3540835605 description: Relationship type.
3540935606 type: string
3541035607 type: object
35608+ RelationshipToIncident:
35609+ description: Relationship to incident.
35610+ properties:
35611+ data:
35612+ $ref: '#/components/schemas/RelationshipToIncidentData'
35613+ required:
35614+ - data
35615+ type: object
3541135616 RelationshipToIncidentAttachment:
3541235617 description: A relationship reference for attachments.
3541335618 properties:
@@ -35432,6 +35637,19 @@ components:
3543235637 - id
3543335638 - type
3543435639 type: object
35640+ RelationshipToIncidentData:
35641+ description: Relationship to incident object.
35642+ properties:
35643+ id:
35644+ description: A unique identifier that represents the incident.
35645+ example: 00000000-0000-0000-1234-000000000000
35646+ type: string
35647+ type:
35648+ $ref: '#/components/schemas/IncidentType'
35649+ required:
35650+ - id
35651+ - type
35652+ type: object
3543535653 RelationshipToIncidentImpactData:
3543635654 description: Relationship to impact object.
3543735655 properties:
@@ -56352,6 +56570,126 @@ paths:
5635256570 x-unstable: '**Note**: This endpoint is in public beta.
5635356571
5635456572 If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
56573+ /api/v2/incidents/{incident_id}/impacts:
56574+ get:
56575+ description: Get all impacts for an incident.
56576+ operationId: ListIncidentImpacts
56577+ parameters:
56578+ - $ref: '#/components/parameters/IncidentIDPathParameter'
56579+ - $ref: '#/components/parameters/IncidentImpactIncludeQueryParameter'
56580+ responses:
56581+ '200':
56582+ content:
56583+ application/json:
56584+ schema:
56585+ $ref: '#/components/schemas/IncidentImpactsResponse'
56586+ description: OK
56587+ '400':
56588+ $ref: '#/components/responses/BadRequestResponse'
56589+ '401':
56590+ $ref: '#/components/responses/UnauthorizedResponse'
56591+ '403':
56592+ $ref: '#/components/responses/ForbiddenResponse'
56593+ '404':
56594+ $ref: '#/components/responses/NotFoundResponse'
56595+ '429':
56596+ $ref: '#/components/responses/TooManyRequestsResponse'
56597+ security:
56598+ - apiKeyAuth: []
56599+ appKeyAuth: []
56600+ - AuthZ:
56601+ - incident_read
56602+ summary: List an incident's impacts
56603+ tags:
56604+ - Incidents
56605+ x-permission:
56606+ operator: OR
56607+ permissions:
56608+ - incident_read
56609+ x-unstable: '**Note**: This endpoint is in public beta.
56610+
56611+ If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
56612+ post:
56613+ description: Create an impact for an incident.
56614+ operationId: CreateIncidentImpact
56615+ parameters:
56616+ - $ref: '#/components/parameters/IncidentIDPathParameter'
56617+ - $ref: '#/components/parameters/IncidentImpactIncludeQueryParameter'
56618+ requestBody:
56619+ content:
56620+ application/json:
56621+ schema:
56622+ $ref: '#/components/schemas/IncidentImpactCreateRequest'
56623+ description: Incident impact payload.
56624+ required: true
56625+ responses:
56626+ '201':
56627+ content:
56628+ application/json:
56629+ schema:
56630+ $ref: '#/components/schemas/IncidentImpactResponse'
56631+ description: CREATED
56632+ '400':
56633+ $ref: '#/components/responses/BadRequestResponse'
56634+ '401':
56635+ $ref: '#/components/responses/UnauthorizedResponse'
56636+ '403':
56637+ $ref: '#/components/responses/ForbiddenResponse'
56638+ '404':
56639+ $ref: '#/components/responses/NotFoundResponse'
56640+ '429':
56641+ $ref: '#/components/responses/TooManyRequestsResponse'
56642+ security:
56643+ - apiKeyAuth: []
56644+ appKeyAuth: []
56645+ - AuthZ:
56646+ - incident_write
56647+ summary: Create an incident impact
56648+ tags:
56649+ - Incidents
56650+ x-codegen-request-body-name: body
56651+ x-permission:
56652+ operator: OR
56653+ permissions:
56654+ - incident_write
56655+ x-unstable: '**Note**: This endpoint is in public beta.
56656+
56657+ If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
56658+ /api/v2/incidents/{incident_id}/impacts/{impact_id}:
56659+ delete:
56660+ description: Delete an incident impact.
56661+ operationId: DeleteIncidentImpact
56662+ parameters:
56663+ - $ref: '#/components/parameters/IncidentIDPathParameter'
56664+ - $ref: '#/components/parameters/IncidentImpactIDPathParameter'
56665+ responses:
56666+ '204':
56667+ description: No Content
56668+ '400':
56669+ $ref: '#/components/responses/BadRequestResponse'
56670+ '401':
56671+ $ref: '#/components/responses/UnauthorizedResponse'
56672+ '403':
56673+ $ref: '#/components/responses/ForbiddenResponse'
56674+ '404':
56675+ $ref: '#/components/responses/NotFoundResponse'
56676+ '429':
56677+ $ref: '#/components/responses/TooManyRequestsResponse'
56678+ security:
56679+ - apiKeyAuth: []
56680+ appKeyAuth: []
56681+ - AuthZ:
56682+ - incident_write
56683+ summary: Delete an incident impact
56684+ tags:
56685+ - Incidents
56686+ x-permission:
56687+ operator: OR
56688+ permissions:
56689+ - incident_write
56690+ x-unstable: '**Note**: This endpoint is in public beta.
56691+
56692+ If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
5635556693 /api/v2/incidents/{incident_id}/relationships/integrations:
5635656694 get:
5635756695 description: Get all integration metadata for an incident.
0 commit comments