@@ -467,6 +467,23 @@ components:
467
467
required: true
468
468
schema:
469
469
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
+ type: string
477
+ IncidentImpactIncludeQueryParameter:
478
+ description: Specifies which related resources should be included in the response.
479
+ explode: false
480
+ in: query
481
+ name: include
482
+ required: false
483
+ schema:
484
+ items:
485
+ $ref: '#/components/schemas/IncidentImpactRelatedObject'
486
+ type: array
470
487
IncidentIncludeQueryParameter:
471
488
description: Specifies which types of related objects should be included in
472
489
the response.
@@ -20120,6 +20137,177 @@ components:
20120
20137
- TEXTARRAY
20121
20138
- METRICTAG
20122
20139
- AUTOCOMPLETE
20140
+ IncidentImpactAttributes:
20141
+ description: The incident impact's attributes.
20142
+ properties:
20143
+ created:
20144
+ description: Timestamp when the impact was created.
20145
+ example: '2025-08-29T13:17:00Z'
20146
+ format: date-time
20147
+ readOnly: true
20148
+ type: string
20149
+ description:
20150
+ description: Description of the impact.
20151
+ example: Service was unavailable for external users
20152
+ type: string
20153
+ end_at:
20154
+ description: Timestamp when the impact ended.
20155
+ example: '2025-08-29T13:17:00Z'
20156
+ format: date-time
20157
+ nullable: true
20158
+ type: string
20159
+ fields:
20160
+ $ref: '#/components/schemas/IncidentImpactFieldsObject'
20161
+ impact_type:
20162
+ description: The type of impact.
20163
+ example: customer
20164
+ type: string
20165
+ modified:
20166
+ description: Timestamp when the impact was last modified.
20167
+ example: '2025-08-29T13:17:00Z'
20168
+ format: date-time
20169
+ readOnly: true
20170
+ type: string
20171
+ start_at:
20172
+ description: Timestamp representing when the impact started.
20173
+ example: '2025-08-28T13:17:00Z'
20174
+ format: date-time
20175
+ type: string
20176
+ required:
20177
+ - description
20178
+ - start_at
20179
+ type: object
20180
+ IncidentImpactCreateAttributes:
20181
+ description: The incident impact's attributes for a create request.
20182
+ properties:
20183
+ description:
20184
+ description: Description of the impact.
20185
+ example: Service was unavailable for external users
20186
+ type: string
20187
+ end_at:
20188
+ description: Timestamp when the impact ended.
20189
+ example: '2025-08-29T13:17:00Z'
20190
+ format: date-time
20191
+ nullable: true
20192
+ type: string
20193
+ fields:
20194
+ $ref: '#/components/schemas/IncidentImpactFieldsObject'
20195
+ start_at:
20196
+ description: Timestamp when the impact started.
20197
+ example: '2025-08-28T13:17:00Z'
20198
+ format: date-time
20199
+ type: string
20200
+ required:
20201
+ - description
20202
+ - start_at
20203
+ type: object
20204
+ IncidentImpactCreateData:
20205
+ description: Incident impact data for a create request.
20206
+ properties:
20207
+ attributes:
20208
+ $ref: '#/components/schemas/IncidentImpactCreateAttributes'
20209
+ type:
20210
+ $ref: '#/components/schemas/IncidentImpactType'
20211
+ required:
20212
+ - type
20213
+ - attributes
20214
+ type: object
20215
+ IncidentImpactCreateRequest:
20216
+ description: Create request for an incident impact.
20217
+ properties:
20218
+ data:
20219
+ $ref: '#/components/schemas/IncidentImpactCreateData'
20220
+ required:
20221
+ - data
20222
+ type: object
20223
+ IncidentImpactFieldsObject:
20224
+ additionalProperties: {}
20225
+ description: An object mapping impact field names to field values.
20226
+ example:
20227
+ customers_impacted: all
20228
+ products_impacted:
20229
+ - shopping
20230
+ - marketing
20231
+ nullable: true
20232
+ type: object
20233
+ IncidentImpactRelatedObject:
20234
+ description: A reference to a resource related to an incident impact.
20235
+ enum:
20236
+ - incident
20237
+ - created_by_user
20238
+ - last_modified_by_user
20239
+ type: string
20240
+ x-enum-varnames:
20241
+ - INCIDENT
20242
+ - CREATED_BY_USER
20243
+ - LAST_MODIFIED_BY_USER
20244
+ IncidentImpactRelationships:
20245
+ description: The incident impact's resource relationships.
20246
+ properties:
20247
+ created_by_user:
20248
+ $ref: '#/components/schemas/RelationshipToUser'
20249
+ incident:
20250
+ $ref: '#/components/schemas/RelationshipToIncident'
20251
+ last_modified_by_user:
20252
+ $ref: '#/components/schemas/RelationshipToUser'
20253
+ type: object
20254
+ IncidentImpactResponse:
20255
+ description: Response with an incident impact.
20256
+ properties:
20257
+ data:
20258
+ $ref: '#/components/schemas/IncidentImpactResponseData'
20259
+ included:
20260
+ description: Included related resources that the user requested.
20261
+ items:
20262
+ $ref: '#/components/schemas/IncidentUserData'
20263
+ readOnly: true
20264
+ type: array
20265
+ required:
20266
+ - data
20267
+ type: object
20268
+ IncidentImpactResponseData:
20269
+ description: Incident impact data from a response.
20270
+ properties:
20271
+ attributes:
20272
+ $ref: '#/components/schemas/IncidentImpactAttributes'
20273
+ id:
20274
+ description: The incident impact's ID.
20275
+ example: 00000000-0000-0000-1234-000000000000
20276
+ type: string
20277
+ relationships:
20278
+ $ref: '#/components/schemas/IncidentImpactRelationships'
20279
+ type:
20280
+ $ref: '#/components/schemas/IncidentImpactType'
20281
+ required:
20282
+ - id
20283
+ - type
20284
+ type: object
20285
+ IncidentImpactType:
20286
+ default: incident_impacts
20287
+ description: Incident impact resource type.
20288
+ enum:
20289
+ - incident_impacts
20290
+ example: incident_impacts
20291
+ type: string
20292
+ x-enum-varnames:
20293
+ - INCIDENT_IMPACTS
20294
+ IncidentImpactsResponse:
20295
+ description: Response with a list of incident impacts.
20296
+ properties:
20297
+ data:
20298
+ description: An array of incident impacts.
20299
+ items:
20300
+ $ref: '#/components/schemas/IncidentImpactResponseData'
20301
+ type: array
20302
+ included:
20303
+ description: Included related resources that the user requested.
20304
+ items:
20305
+ $ref: '#/components/schemas/IncidentUserData'
20306
+ readOnly: true
20307
+ type: array
20308
+ required:
20309
+ - data
20310
+ type: object
20123
20311
IncidentImpactsType:
20124
20312
description: The incident impacts type.
20125
20313
enum:
@@ -20897,6 +21085,7 @@ components:
20897
21085
- data
20898
21086
type: object
20899
21087
IncidentResponseAttributes:
21088
+ additionalProperties: {}
20900
21089
description: The incident's attributes from a response.
20901
21090
properties:
20902
21091
archived:
@@ -20941,6 +21130,17 @@ components:
20941
21130
description: A flag indicating whether the incident caused customer impact.
20942
21131
example: false
20943
21132
type: boolean
21133
+ declared:
21134
+ description: Timestamp when the incident was declared.
21135
+ format: date-time
21136
+ readOnly: true
21137
+ type: string
21138
+ declared_by:
21139
+ $ref: '#/components/schemas/IncidentNonDatadogCreator'
21140
+ declared_by_uuid:
21141
+ description: UUID of the user who declared the incident.
21142
+ nullable: true
21143
+ type: string
20944
21144
detected:
20945
21145
description: Timestamp when the incident was detected.
20946
21146
format: date-time
@@ -21096,6 +21296,8 @@ components:
21096
21296
$ref: '#/components/schemas/NullableRelationshipToUser'
21097
21297
created_by_user:
21098
21298
$ref: '#/components/schemas/RelationshipToUser'
21299
+ declared_by_user:
21300
+ $ref: '#/components/schemas/RelationshipToUser'
21099
21301
impacts:
21100
21302
$ref: '#/components/schemas/RelationshipToIncidentImpacts'
21101
21303
integrations:
@@ -35408,6 +35610,14 @@ components:
35408
35610
description: Relationship type.
35409
35611
type: string
35410
35612
type: object
35613
+ RelationshipToIncident:
35614
+ description: Relationship to incident.
35615
+ properties:
35616
+ data:
35617
+ $ref: '#/components/schemas/RelationshipToIncidentData'
35618
+ required:
35619
+ - data
35620
+ type: object
35411
35621
RelationshipToIncidentAttachment:
35412
35622
description: A relationship reference for attachments.
35413
35623
properties:
@@ -35432,6 +35642,19 @@ components:
35432
35642
- id
35433
35643
- type
35434
35644
type: object
35645
+ RelationshipToIncidentData:
35646
+ description: Relationship to incident object.
35647
+ properties:
35648
+ id:
35649
+ description: A unique identifier that represents the incident.
35650
+ example: 00000000-0000-0000-1234-000000000000
35651
+ type: string
35652
+ type:
35653
+ $ref: '#/components/schemas/IncidentType'
35654
+ required:
35655
+ - id
35656
+ - type
35657
+ type: object
35435
35658
RelationshipToIncidentImpactData:
35436
35659
description: Relationship to impact object.
35437
35660
properties:
@@ -56352,6 +56575,124 @@ paths:
56352
56575
x-unstable: '**Note**: This endpoint is in public beta.
56353
56576
56354
56577
If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
56578
+ /api/v2/incidents/{incident_id}/impacts:
56579
+ get:
56580
+ description: Get all impacts for an incident.
56581
+ operationId: ListIncidentImpacts
56582
+ parameters:
56583
+ - $ref: '#/components/parameters/IncidentIDPathParameter'
56584
+ - $ref: '#/components/parameters/IncidentImpactIncludeQueryParameter'
56585
+ responses:
56586
+ '200':
56587
+ content:
56588
+ application/json:
56589
+ schema:
56590
+ $ref: '#/components/schemas/IncidentImpactsResponse'
56591
+ description: OK
56592
+ '400':
56593
+ $ref: '#/components/responses/BadRequestResponse'
56594
+ '401':
56595
+ $ref: '#/components/responses/UnauthorizedResponse'
56596
+ '403':
56597
+ $ref: '#/components/responses/ForbiddenResponse'
56598
+ '404':
56599
+ $ref: '#/components/responses/NotFoundResponse'
56600
+ '429':
56601
+ $ref: '#/components/responses/TooManyRequestsResponse'
56602
+ security:
56603
+ - apiKeyAuth: []
56604
+ appKeyAuth: []
56605
+ - AuthZ:
56606
+ - incident_read
56607
+ summary: List an incident's impacts
56608
+ tags:
56609
+ - Incidents
56610
+ x-permission:
56611
+ operator: OR
56612
+ permissions:
56613
+ - incident_read
56614
+ x-unstable: '**Note**: This endpoint is in public beta.
56615
+
56616
+ If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
56617
+ post:
56618
+ description: Create an impact for an incident.
56619
+ operationId: CreateIncidentImpact
56620
+ parameters:
56621
+ - $ref: '#/components/parameters/IncidentIDPathParameter'
56622
+ - $ref: '#/components/parameters/IncidentImpactIncludeQueryParameter'
56623
+ requestBody:
56624
+ content:
56625
+ application/json:
56626
+ schema:
56627
+ $ref: '#/components/schemas/IncidentImpactCreateRequest'
56628
+ description: Incident impact payload.
56629
+ required: true
56630
+ responses:
56631
+ '201':
56632
+ content:
56633
+ application/json:
56634
+ schema:
56635
+ $ref: '#/components/schemas/IncidentImpactResponse'
56636
+ description: CREATED
56637
+ '400':
56638
+ $ref: '#/components/responses/BadRequestResponse'
56639
+ '401':
56640
+ $ref: '#/components/responses/UnauthorizedResponse'
56641
+ '403':
56642
+ $ref: '#/components/responses/ForbiddenResponse'
56643
+ '404':
56644
+ $ref: '#/components/responses/NotFoundResponse'
56645
+ '429':
56646
+ $ref: '#/components/responses/TooManyRequestsResponse'
56647
+ security:
56648
+ - apiKeyAuth: []
56649
+ appKeyAuth: []
56650
+ - AuthZ:
56651
+ - incident_write
56652
+ summary: Create an incident impact
56653
+ tags:
56654
+ - Incidents
56655
+ x-codegen-request-body-name: body
56656
+ x-permission:
56657
+ operator: OR
56658
+ permissions:
56659
+ - incident_write
56660
+ x-unstable: '**Note**: This endpoint is in public beta.
56661
+
56662
+ If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
56663
+ /api/v2/incidents/{incident_id}/impacts/{impact_id}:
56664
+ delete:
56665
+ description: Delete an incident impact.
56666
+ operationId: DeleteIncidentImpact
56667
+ parameters:
56668
+ - $ref: '#/components/parameters/IncidentIDPathParameter'
56669
+ - $ref: '#/components/parameters/IncidentImpactIDPathParameter'
56670
+ responses:
56671
+ '204':
56672
+ description: No Content
56673
+ '401':
56674
+ $ref: '#/components/responses/UnauthorizedResponse'
56675
+ '403':
56676
+ $ref: '#/components/responses/ForbiddenResponse'
56677
+ '404':
56678
+ $ref: '#/components/responses/NotFoundResponse'
56679
+ '429':
56680
+ $ref: '#/components/responses/TooManyRequestsResponse'
56681
+ security:
56682
+ - apiKeyAuth: []
56683
+ appKeyAuth: []
56684
+ - AuthZ:
56685
+ - incident_write
56686
+ summary: Delete an incident impact
56687
+ tags:
56688
+ - Incidents
56689
+ x-permission:
56690
+ operator: OR
56691
+ permissions:
56692
+ - incident_write
56693
+ x-unstable: '**Note**: This endpoint is in public beta.
56694
+
56695
+ If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
56355
56696
/api/v2/incidents/{incident_id}/relationships/integrations:
56356
56697
get:
56357
56698
description: Get all integration metadata for an incident.
0 commit comments