@@ -11049,6 +11049,25 @@ components:
11049
11049
type: string
11050
11050
x-enum-varnames:
11051
11051
- DORA_DEPLOYMENT
11052
+ DORAEvent:
11053
+ description: A DORA event.
11054
+ properties:
11055
+ attributes:
11056
+ description: The attributes of the event.
11057
+ type: object
11058
+ id:
11059
+ description: The ID of the event.
11060
+ type: string
11061
+ type:
11062
+ description: The type of the event.
11063
+ type: string
11064
+ type: object
11065
+ DORAFetchResponse:
11066
+ description: Response for the DORA fetch endpoints.
11067
+ properties:
11068
+ data:
11069
+ $ref: '#/components/schemas/DORAEvent'
11070
+ type: object
11052
11071
DORAGitInfo:
11053
11072
description: Git info for DORA Metrics events.
11054
11073
properties:
@@ -11084,7 +11103,8 @@ components:
11084
11103
git:
11085
11104
$ref: '#/components/schemas/DORAGitInfo'
11086
11105
id:
11087
- description: Incident ID. Required to update a previously sent incident.
11106
+ description: Incident ID. Must have at least 16 characters. Required to
11107
+ update a previously sent incident.
11088
11108
type: string
11089
11109
name:
11090
11110
description: Incident name.
@@ -11159,6 +11179,113 @@ components:
11159
11179
type: string
11160
11180
x-enum-varnames:
11161
11181
- DORA_INCIDENT
11182
+ DORAListDeploymentsRequest:
11183
+ description: Request to get a list of deployments.
11184
+ properties:
11185
+ data:
11186
+ $ref: '#/components/schemas/DORAListDeploymentsRequestData'
11187
+ required:
11188
+ - data
11189
+ type: object
11190
+ DORAListDeploymentsRequestAttributes:
11191
+ description: Attributes to get a list of deployments.
11192
+ properties:
11193
+ from:
11194
+ description: Minimum timestamp for requested events.
11195
+ format: date-time
11196
+ type: string
11197
+ limit:
11198
+ default: 10
11199
+ description: Maximum number of events in the response.
11200
+ format: int32
11201
+ maximum: 1000
11202
+ type: integer
11203
+ query:
11204
+ description: Search query with event platform syntax.
11205
+ type: string
11206
+ sort:
11207
+ description: Sort order (prefixed with `-` for descending).
11208
+ type: string
11209
+ to:
11210
+ description: Maximum timestamp for requested events.
11211
+ format: date-time
11212
+ type: string
11213
+ type: object
11214
+ DORAListDeploymentsRequestData:
11215
+ description: The JSON:API data.
11216
+ properties:
11217
+ attributes:
11218
+ $ref: '#/components/schemas/DORAListDeploymentsRequestAttributes'
11219
+ type:
11220
+ $ref: '#/components/schemas/DORAListDeploymentsRequestDataType'
11221
+ required:
11222
+ - attributes
11223
+ type: object
11224
+ DORAListDeploymentsRequestDataType:
11225
+ description: The definition of `DORAListDeploymentsRequestDataType` object.
11226
+ enum:
11227
+ - dora_deployments_list_request
11228
+ type: string
11229
+ x-enum-varnames:
11230
+ - DORA_DEPLOYMENTS_LIST_REQUEST
11231
+ DORAListFailuresRequest:
11232
+ description: Request to get a list of failures.
11233
+ properties:
11234
+ data:
11235
+ $ref: '#/components/schemas/DORAListFailuresRequestData'
11236
+ required:
11237
+ - data
11238
+ type: object
11239
+ DORAListFailuresRequestAttributes:
11240
+ description: Attributes to get a list of failures.
11241
+ properties:
11242
+ from:
11243
+ description: Minimum timestamp for requested events.
11244
+ format: date-time
11245
+ type: string
11246
+ limit:
11247
+ default: 10
11248
+ description: Maximum number of events in the response.
11249
+ format: int32
11250
+ maximum: 1000
11251
+ type: integer
11252
+ query:
11253
+ description: Search query with event platform syntax.
11254
+ type: string
11255
+ sort:
11256
+ description: Sort order (prefixed with `-` for descending).
11257
+ type: string
11258
+ to:
11259
+ description: Maximum timestamp for requested events.
11260
+ format: date-time
11261
+ type: string
11262
+ type: object
11263
+ DORAListFailuresRequestData:
11264
+ description: The JSON:API data.
11265
+ properties:
11266
+ attributes:
11267
+ $ref: '#/components/schemas/DORAListFailuresRequestAttributes'
11268
+ type:
11269
+ $ref: '#/components/schemas/DORAListFailuresRequestDataType'
11270
+ required:
11271
+ - attributes
11272
+ type: object
11273
+ DORAListFailuresRequestDataType:
11274
+ description: The definition of `DORAListFailuresRequestDataType` object.
11275
+ enum:
11276
+ - dora_failures_list_request
11277
+ type: string
11278
+ x-enum-varnames:
11279
+ - DORA_FAILURES_LIST_REQUEST
11280
+ DORAListResponse:
11281
+ description: Response for the DORA list endpoints.
11282
+ properties:
11283
+ data:
11284
+ description: The list of DORA events.
11285
+ items:
11286
+ $ref: '#/components/schemas/DORAEvent'
11287
+ type: array
11288
+ type: object
11162
11289
DashboardListAddItemsRequest:
11163
11290
description: Request containing a list of dashboards to add.
11164
11291
properties:
@@ -45500,10 +45627,163 @@ paths:
45500
45627
x-unstable: '**Note**: This endpoint is in public beta.
45501
45628
45502
45629
If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
45630
+ /api/v2/dora/deployments:
45631
+ post:
45632
+ description: Use this API endpoint to get a list of deployment events.
45633
+ operationId: ListDORADeployments
45634
+ requestBody:
45635
+ content:
45636
+ application/json:
45637
+ schema:
45638
+ $ref: '#/components/schemas/DORAListDeploymentsRequest'
45639
+ required: true
45640
+ responses:
45641
+ '200':
45642
+ content:
45643
+ application/json:
45644
+ schema:
45645
+ $ref: '#/components/schemas/DORAListResponse'
45646
+ description: OK
45647
+ '400':
45648
+ content:
45649
+ application/json:
45650
+ schema:
45651
+ $ref: '#/components/schemas/JSONAPIErrorResponse'
45652
+ description: Bad Request
45653
+ '403':
45654
+ $ref: '#/components/responses/NotAuthorizedResponse'
45655
+ '429':
45656
+ $ref: '#/components/responses/TooManyRequestsResponse'
45657
+ security:
45658
+ - apiKeyAuth: []
45659
+ appKeyAuth: []
45660
+ summary: Get a list of deployment events
45661
+ tags:
45662
+ - DORA Metrics
45663
+ x-codegen-request-body-name: body
45664
+ x-permission:
45665
+ operator: OR
45666
+ permissions:
45667
+ - dora_metrics_read
45668
+ /api/v2/dora/deployments/{deployment_id}:
45669
+ get:
45670
+ description: Use this API endpoint to get a deployment event.
45671
+ operationId: GetDORADeployment
45672
+ parameters:
45673
+ - description: The ID of the deployment event.
45674
+ in: path
45675
+ name: deployment_id
45676
+ required: true
45677
+ schema:
45678
+ type: string
45679
+ responses:
45680
+ '200':
45681
+ content:
45682
+ application/json:
45683
+ schema:
45684
+ $ref: '#/components/schemas/DORAFetchResponse'
45685
+ description: OK
45686
+ '400':
45687
+ content:
45688
+ application/json:
45689
+ schema:
45690
+ $ref: '#/components/schemas/JSONAPIErrorResponse'
45691
+ description: Bad Request
45692
+ '403':
45693
+ $ref: '#/components/responses/NotAuthorizedResponse'
45694
+ '429':
45695
+ $ref: '#/components/responses/TooManyRequestsResponse'
45696
+ security:
45697
+ - apiKeyAuth: []
45698
+ - appKeyAuth: []
45699
+ summary: Get a deployment event
45700
+ tags:
45701
+ - DORA Metrics
45702
+ x-codegen-request-body-name: body
45703
+ x-permission:
45704
+ operator: OR
45705
+ permissions:
45706
+ - dora_metrics_read
45707
+ /api/v2/dora/failures:
45708
+ post:
45709
+ description: Use this API endpoint to get a list of failure events.
45710
+ operationId: ListDORAFailures
45711
+ requestBody:
45712
+ content:
45713
+ application/json:
45714
+ schema:
45715
+ $ref: '#/components/schemas/DORAListFailuresRequest'
45716
+ required: true
45717
+ responses:
45718
+ '200':
45719
+ content:
45720
+ application/json:
45721
+ schema:
45722
+ $ref: '#/components/schemas/DORAListResponse'
45723
+ description: OK
45724
+ '400':
45725
+ content:
45726
+ application/json:
45727
+ schema:
45728
+ $ref: '#/components/schemas/JSONAPIErrorResponse'
45729
+ description: Bad Request
45730
+ '403':
45731
+ $ref: '#/components/responses/NotAuthorizedResponse'
45732
+ '429':
45733
+ $ref: '#/components/responses/TooManyRequestsResponse'
45734
+ security:
45735
+ - apiKeyAuth: []
45736
+ appKeyAuth: []
45737
+ summary: Get a list of failure events
45738
+ tags:
45739
+ - DORA Metrics
45740
+ x-codegen-request-body-name: body
45741
+ x-permission:
45742
+ operator: OR
45743
+ permissions:
45744
+ - dora_metrics_read
45745
+ /api/v2/dora/failures/{failure_id}:
45746
+ get:
45747
+ description: Use this API endpoint to get a failure event.
45748
+ operationId: GetDORAFailure
45749
+ parameters:
45750
+ - description: The ID of the failure event.
45751
+ in: path
45752
+ name: failure_id
45753
+ required: true
45754
+ schema:
45755
+ type: string
45756
+ responses:
45757
+ '200':
45758
+ content:
45759
+ application/json:
45760
+ schema:
45761
+ $ref: '#/components/schemas/DORAFetchResponse'
45762
+ description: OK
45763
+ '400':
45764
+ content:
45765
+ application/json:
45766
+ schema:
45767
+ $ref: '#/components/schemas/JSONAPIErrorResponse'
45768
+ description: Bad Request
45769
+ '403':
45770
+ $ref: '#/components/responses/NotAuthorizedResponse'
45771
+ '429':
45772
+ $ref: '#/components/responses/TooManyRequestsResponse'
45773
+ security:
45774
+ - apiKeyAuth: []
45775
+ - appKeyAuth: []
45776
+ summary: Get a failure event
45777
+ tags:
45778
+ - DORA Metrics
45779
+ x-codegen-request-body-name: body
45780
+ x-permission:
45781
+ operator: OR
45782
+ permissions:
45783
+ - dora_metrics_read
45503
45784
/api/v2/dora/incident:
45504
45785
post:
45505
- description: 'Use this API endpoint to provide data about incidents for DORA
45506
- metrics.
45786
+ description: 'Use this API endpoint to provide failure data for DORA metrics.
45507
45787
45508
45788
45509
45789
This is necessary for:
@@ -61873,9 +62153,12 @@ tags:
61873
62153
See the [Container Monitoring page](https://docs.datadoghq.com/containers/) for
61874
62154
more information.
61875
62155
name: Containers
61876
- - description: Send events for DORA Metrics to measure and improve software delivery.
61877
- See the [DORA Metrics page](https://docs.datadoghq.com/dora_metrics/) for more
61878
- information.
62156
+ - description: 'Search or send events for DORA Metrics to measure and improve your
62157
+ software delivery performance. See the [DORA Metrics page](https://docs.datadoghq.com/dora_metrics/)
62158
+ for more information.
62159
+
62160
+
62161
+ **Note**: DORA Metrics are not available in the US1-FED site.'
61879
62162
name: DORA Metrics
61880
62163
- description: 'Interact with your dashboard lists through the API to
61881
62164
0 commit comments