@@ -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:
@@ -35408,6 +35591,14 @@ components:
3540835591 description: Relationship type.
3540935592 type: string
3541035593 type: object
35594+ RelationshipToIncident:
35595+ description: Relationship to incident.
35596+ properties:
35597+ data:
35598+ $ref: '#/components/schemas/RelationshipToIncidentData'
35599+ required:
35600+ - data
35601+ type: object
3541135602 RelationshipToIncidentAttachment:
3541235603 description: A relationship reference for attachments.
3541335604 properties:
@@ -35432,6 +35623,19 @@ components:
3543235623 - id
3543335624 - type
3543435625 type: object
35626+ RelationshipToIncidentData:
35627+ description: Relationship to incident object.
35628+ properties:
35629+ id:
35630+ description: A unique identifier that represents the incident.
35631+ example: 00000000-0000-0000-1234-000000000000
35632+ type: string
35633+ type:
35634+ $ref: '#/components/schemas/IncidentType'
35635+ required:
35636+ - id
35637+ - type
35638+ type: object
3543535639 RelationshipToIncidentImpactData:
3543635640 description: Relationship to impact object.
3543735641 properties:
@@ -56352,6 +56556,126 @@ paths:
5635256556 x-unstable: '**Note**: This endpoint is in public beta.
5635356557
5635456558 If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
56559+ /api/v2/incidents/{incident_id}/impacts:
56560+ get:
56561+ description: Get all impacts for an incident.
56562+ operationId: ListIncidentImpacts
56563+ parameters:
56564+ - $ref: '#/components/parameters/IncidentIDPathParameter'
56565+ - $ref: '#/components/parameters/IncidentImpactIncludeQueryParameter'
56566+ responses:
56567+ '200':
56568+ content:
56569+ application/json:
56570+ schema:
56571+ $ref: '#/components/schemas/IncidentImpactsResponse'
56572+ description: OK
56573+ '400':
56574+ $ref: '#/components/responses/BadRequestResponse'
56575+ '401':
56576+ $ref: '#/components/responses/UnauthorizedResponse'
56577+ '403':
56578+ $ref: '#/components/responses/ForbiddenResponse'
56579+ '404':
56580+ $ref: '#/components/responses/NotFoundResponse'
56581+ '429':
56582+ $ref: '#/components/responses/TooManyRequestsResponse'
56583+ security:
56584+ - apiKeyAuth: []
56585+ appKeyAuth: []
56586+ - AuthZ:
56587+ - incident_read
56588+ summary: List an incident's impacts
56589+ tags:
56590+ - Incidents
56591+ x-permission:
56592+ operator: OR
56593+ permissions:
56594+ - incident_read
56595+ x-unstable: '**Note**: This endpoint is in public beta.
56596+
56597+ If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
56598+ post:
56599+ description: Create an impact for an incident.
56600+ operationId: CreateIncidentImpact
56601+ parameters:
56602+ - $ref: '#/components/parameters/IncidentIDPathParameter'
56603+ - $ref: '#/components/parameters/IncidentImpactIncludeQueryParameter'
56604+ requestBody:
56605+ content:
56606+ application/json:
56607+ schema:
56608+ $ref: '#/components/schemas/IncidentImpactCreateRequest'
56609+ description: Incident impact payload.
56610+ required: true
56611+ responses:
56612+ '201':
56613+ content:
56614+ application/json:
56615+ schema:
56616+ $ref: '#/components/schemas/IncidentImpactResponse'
56617+ description: CREATED
56618+ '400':
56619+ $ref: '#/components/responses/BadRequestResponse'
56620+ '401':
56621+ $ref: '#/components/responses/UnauthorizedResponse'
56622+ '403':
56623+ $ref: '#/components/responses/ForbiddenResponse'
56624+ '404':
56625+ $ref: '#/components/responses/NotFoundResponse'
56626+ '429':
56627+ $ref: '#/components/responses/TooManyRequestsResponse'
56628+ security:
56629+ - apiKeyAuth: []
56630+ appKeyAuth: []
56631+ - AuthZ:
56632+ - incident_write
56633+ summary: Create an incident impact
56634+ tags:
56635+ - Incidents
56636+ x-codegen-request-body-name: body
56637+ x-permission:
56638+ operator: OR
56639+ permissions:
56640+ - incident_write
56641+ x-unstable: '**Note**: This endpoint is in public beta.
56642+
56643+ If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
56644+ /api/v2/incidents/{incident_id}/impacts/{impact_id}:
56645+ delete:
56646+ description: Delete an incident impact.
56647+ operationId: DeleteIncidentImpact
56648+ parameters:
56649+ - $ref: '#/components/parameters/IncidentIDPathParameter'
56650+ - $ref: '#/components/parameters/IncidentImpactIDPathParameter'
56651+ responses:
56652+ '204':
56653+ description: No Content
56654+ '400':
56655+ $ref: '#/components/responses/BadRequestResponse'
56656+ '401':
56657+ $ref: '#/components/responses/UnauthorizedResponse'
56658+ '403':
56659+ $ref: '#/components/responses/ForbiddenResponse'
56660+ '404':
56661+ $ref: '#/components/responses/NotFoundResponse'
56662+ '429':
56663+ $ref: '#/components/responses/TooManyRequestsResponse'
56664+ security:
56665+ - apiKeyAuth: []
56666+ appKeyAuth: []
56667+ - AuthZ:
56668+ - incident_write
56669+ summary: Delete an incident impact
56670+ tags:
56671+ - Incidents
56672+ x-permission:
56673+ operator: OR
56674+ permissions:
56675+ - incident_write
56676+ x-unstable: '**Note**: This endpoint is in public beta.
56677+
56678+ If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
5635556679 /api/v2/incidents/{incident_id}/relationships/integrations:
5635656680 get:
5635756681 description: Get all integration metadata for an incident.
0 commit comments