@@ -839,6 +839,11 @@ components:
839
839
type: string
840
840
x-enum-varnames:
841
841
- BILLING_DIMENSIONS
842
+ ApiID:
843
+ description: API identifier.
844
+ example: 90646597-5fdb-4a17-a240-647003f8c028
845
+ format: uuid
846
+ type: string
842
847
ApmRetentionFilterType:
843
848
default: apm_retention_filter
844
849
description: The type of the resource.
@@ -4873,6 +4878,29 @@ components:
4873
4878
type: string
4874
4879
x-enum-varnames:
4875
4880
- COST_BY_ORG
4881
+ CreateOpenAPIResponse:
4882
+ description: Response for `CreateOpenAPI` operation.
4883
+ properties:
4884
+ data:
4885
+ $ref: '#/components/schemas/CreateOpenAPIResponseData'
4886
+ type: object
4887
+ CreateOpenAPIResponseAttributes:
4888
+ description: Attributes for `CreateOpenAPI`.
4889
+ properties:
4890
+ failed_endpoints:
4891
+ description: List of endpoints which couldn't be parsed.
4892
+ items:
4893
+ $ref: '#/components/schemas/OpenAPIEndpoint'
4894
+ type: array
4895
+ type: object
4896
+ CreateOpenAPIResponseData:
4897
+ description: Data envelope for `CreateOpenAPIResponse`.
4898
+ properties:
4899
+ attributes:
4900
+ $ref: '#/components/schemas/CreateOpenAPIResponseAttributes'
4901
+ id:
4902
+ $ref: '#/components/schemas/ApiID'
4903
+ type: object
4876
4904
CreateRuleRequest:
4877
4905
description: Scorecard create rule request.
4878
4906
properties:
@@ -12079,6 +12107,24 @@ components:
12079
12107
type: string
12080
12108
x-enum-varnames:
12081
12109
- ON_DEMAND_CONCURRENCY_CAP
12110
+ OpenAPIEndpoint:
12111
+ description: Endpoint info extracted from an `OpenAPI` specification.
12112
+ properties:
12113
+ method:
12114
+ description: The endpoint method.
12115
+ type: string
12116
+ path:
12117
+ description: The endpoint path.
12118
+ type: string
12119
+ type: object
12120
+ OpenAPIFile:
12121
+ description: Object for API data in an `OpenAPI` format as a file.
12122
+ properties:
12123
+ openapi_spec_file:
12124
+ description: Binary `OpenAPI` spec file
12125
+ format: binary
12126
+ type: string
12127
+ type: object
12082
12128
OpsgenieServiceCreateAttributes:
12083
12129
description: The Opsgenie service attributes for a create request.
12084
12130
properties:
@@ -20281,6 +20327,29 @@ components:
20281
20327
example: min
20282
20328
type: string
20283
20329
type: object
20330
+ UpdateOpenAPIResponse:
20331
+ description: Response for `UpdateOpenAPI`.
20332
+ properties:
20333
+ data:
20334
+ $ref: '#/components/schemas/UpdateOpenAPIResponseData'
20335
+ type: object
20336
+ UpdateOpenAPIResponseAttributes:
20337
+ description: Attributes for `UpdateOpenAPI`.
20338
+ properties:
20339
+ failed_endpoints:
20340
+ description: List of endpoints which couldn't be parsed.
20341
+ items:
20342
+ $ref: '#/components/schemas/OpenAPIEndpoint'
20343
+ type: array
20344
+ type: object
20345
+ UpdateOpenAPIResponseData:
20346
+ description: Data envelope for `UpdateOpenAPIResponse`.
20347
+ properties:
20348
+ attributes:
20349
+ $ref: '#/components/schemas/UpdateOpenAPIResponseAttributes'
20350
+ id:
20351
+ $ref: '#/components/schemas/ApiID'
20352
+ type: object
20284
20353
UsageApplicationSecurityMonitoringResponse:
20285
20354
description: Application Security Monitoring usage response.
20286
20355
properties:
@@ -21107,6 +21176,190 @@ paths:
21107
21176
tags:
21108
21177
- Key Management
21109
21178
x-codegen-request-body-name: body
21179
+ /api/v2/apicatalog/api/{id}:
21180
+ delete:
21181
+ description: Delete a specific API by ID.
21182
+ operationId: DeleteOpenAPI
21183
+ parameters:
21184
+ - description: ID of the API to delete
21185
+ in: path
21186
+ name: id
21187
+ required: true
21188
+ schema:
21189
+ $ref: '#/components/schemas/ApiID'
21190
+ responses:
21191
+ '204':
21192
+ description: API deleted successfully
21193
+ '400':
21194
+ content:
21195
+ application/json:
21196
+ schema:
21197
+ $ref: '#/components/schemas/JSONAPIErrorResponse'
21198
+ description: Bad request
21199
+ '403':
21200
+ content:
21201
+ application/json:
21202
+ schema:
21203
+ $ref: '#/components/schemas/JSONAPIErrorResponse'
21204
+ description: Forbidden
21205
+ '404':
21206
+ content:
21207
+ application/json:
21208
+ schema:
21209
+ $ref: '#/components/schemas/JSONAPIErrorResponse'
21210
+ description: API not found error
21211
+ '429':
21212
+ $ref: '#/components/responses/TooManyRequestsResponse'
21213
+ summary: Delete an API
21214
+ tags:
21215
+ - API Management
21216
+ x-unstable: '**Note**: This endpoint is in public beta.
21217
+
21218
+ If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
21219
+ /api/v2/apicatalog/api/{id}/openapi:
21220
+ get:
21221
+ description: Retrieve information about a specific API in [OpenAPI](https://spec.openapis.org/oas/latest.html)
21222
+ format file.
21223
+ operationId: GetOpenAPI
21224
+ parameters:
21225
+ - description: ID of the API to retrieve
21226
+ in: path
21227
+ name: id
21228
+ required: true
21229
+ schema:
21230
+ $ref: '#/components/schemas/ApiID'
21231
+ responses:
21232
+ '200':
21233
+ content:
21234
+ multipart/form-data:
21235
+ schema:
21236
+ format: binary
21237
+ type: string
21238
+ description: OK
21239
+ '400':
21240
+ content:
21241
+ application/json:
21242
+ schema:
21243
+ $ref: '#/components/schemas/JSONAPIErrorResponse'
21244
+ description: Bad request
21245
+ '403':
21246
+ content:
21247
+ application/json:
21248
+ schema:
21249
+ $ref: '#/components/schemas/JSONAPIErrorResponse'
21250
+ description: Forbidden
21251
+ '404':
21252
+ content:
21253
+ application/json:
21254
+ schema:
21255
+ $ref: '#/components/schemas/JSONAPIErrorResponse'
21256
+ description: API not found error
21257
+ '429':
21258
+ $ref: '#/components/responses/TooManyRequestsResponse'
21259
+ summary: Get an API
21260
+ tags:
21261
+ - API Management
21262
+ x-unstable: '**Note**: This endpoint is in public beta.
21263
+
21264
+ If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
21265
+ put:
21266
+ description: Update information about a specific API. The given content will
21267
+ replace all API content of the given ID.
21268
+ operationId: UpdateOpenAPI
21269
+ parameters:
21270
+ - description: ID of the API to modify
21271
+ in: path
21272
+ name: id
21273
+ required: true
21274
+ schema:
21275
+ $ref: '#/components/schemas/ApiID'
21276
+ requestBody:
21277
+ content:
21278
+ multipart/form-data:
21279
+ schema:
21280
+ $ref: '#/components/schemas/OpenAPIFile'
21281
+ required: true
21282
+ responses:
21283
+ '200':
21284
+ content:
21285
+ application/json:
21286
+ schema:
21287
+ $ref: '#/components/schemas/UpdateOpenAPIResponse'
21288
+ description: API updated successfully
21289
+ '400':
21290
+ content:
21291
+ application/json:
21292
+ schema:
21293
+ $ref: '#/components/schemas/JSONAPIErrorResponse'
21294
+ description: Bad request
21295
+ '403':
21296
+ content:
21297
+ application/json:
21298
+ schema:
21299
+ $ref: '#/components/schemas/JSONAPIErrorResponse'
21300
+ description: Forbidden
21301
+ '404':
21302
+ content:
21303
+ application/json:
21304
+ schema:
21305
+ $ref: '#/components/schemas/JSONAPIErrorResponse'
21306
+ description: API not found error
21307
+ '429':
21308
+ $ref: '#/components/responses/TooManyRequestsResponse'
21309
+ summary: Update an API
21310
+ tags:
21311
+ - API Management
21312
+ x-unstable: '**Note**: This endpoint is in public beta.
21313
+
21314
+ If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
21315
+ /api/v2/apicatalog/openapi:
21316
+ post:
21317
+ description: 'Create a new API from the [OpenAPI](https://spec.openapis.org/oas/latest.html)
21318
+ specification given.
21319
+
21320
+ It supports version `2.0`, `3.0` and `3.1` of the specification. A specific
21321
+ extension section, `x-datadog`,
21322
+
21323
+ let you specify the `teamHandle` for your team responsible for the API in
21324
+ Datadog.
21325
+
21326
+ It returns the created API ID.
21327
+
21328
+ '
21329
+ operationId: CreateOpenAPI
21330
+ requestBody:
21331
+ content:
21332
+ multipart/form-data:
21333
+ schema:
21334
+ $ref: '#/components/schemas/OpenAPIFile'
21335
+ required: true
21336
+ responses:
21337
+ '201':
21338
+ content:
21339
+ application/json:
21340
+ schema:
21341
+ $ref: '#/components/schemas/CreateOpenAPIResponse'
21342
+ description: API created successfully
21343
+ '400':
21344
+ content:
21345
+ application/json:
21346
+ schema:
21347
+ $ref: '#/components/schemas/JSONAPIErrorResponse'
21348
+ description: Bad request
21349
+ '403':
21350
+ content:
21351
+ application/json:
21352
+ schema:
21353
+ $ref: '#/components/schemas/JSONAPIErrorResponse'
21354
+ description: Forbidden
21355
+ '429':
21356
+ $ref: '#/components/responses/TooManyRequestsResponse'
21357
+ summary: Create a new API
21358
+ tags:
21359
+ - API Management
21360
+ x-unstable: '**Note**: This endpoint is in public beta.
21361
+
21362
+ If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
21110
21363
/api/v2/apm/config/metrics:
21111
21364
get:
21112
21365
description: Get the list of configured span-based metrics with their definitions.
@@ -33170,6 +33423,8 @@ servers:
33170
33423
default: api
33171
33424
description: The subdomain where the API is deployed.
33172
33425
tags:
33426
+ - description: Configure your API endpoints through the Datadog API.
33427
+ name: API Management
33173
33428
- description: Manage configuration of [APM retention filters](https://app.datadoghq.com/apm/traces/retention-filters)
33174
33429
for your organization. You need an API and application key with Admin rights to
33175
33430
interact with this endpoint. See [retention filters](https://docs.datadoghq.com/tracing/trace_pipeline/trace_retention/#retention-filters)
0 commit comments