Skip to content

Commit 8e32aeb

Browse files
author
ci.datadog-api-spec
committed
Regenerate client from commit f9d6728 of spec repo
1 parent fa788a4 commit 8e32aeb

18 files changed

Lines changed: 1126 additions & 0 deletions

‎.generator/schemas/v2/openapi.yaml‎

Lines changed: 332 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18173,6 +18173,25 @@ components:
1817318173
- tag_key
1817418174
- updated_at
1817518175
type: object
18176+
CostTagDescriptionResponse:
18177+
description: Single Cloud Cost Management tag key description returned by the get-by-key endpoint.
18178+
example:
18179+
data:
18180+
attributes:
18181+
cloud: aws
18182+
created_at: "2026-01-01T12:00:00Z"
18183+
description: AWS account that owns this cost.
18184+
source: human
18185+
tag_key: account_id
18186+
updated_at: "2026-01-01T12:00:00Z"
18187+
id: account_id
18188+
type: cost_tag_description
18189+
properties:
18190+
data:
18191+
$ref: "#/components/schemas/CostTagDescription"
18192+
required:
18193+
- data
18194+
type: object
1817618195
CostTagDescriptionSource:
1817718196
description: Origin of the description. `human` indicates the description was written by a user, `ai_generated` was produced by AI, and `datadog` is a default supplied by Datadog.
1817818197
enum:
@@ -18194,6 +18213,50 @@ components:
1819418213
type: string
1819518214
x-enum-varnames:
1819618215
- COST_TAG_DESCRIPTION
18216+
CostTagDescriptionUpsertRequest:
18217+
description: Request body for creating or updating a Cloud Cost Management tag key description.
18218+
example:
18219+
data:
18220+
attributes:
18221+
cloud: aws
18222+
description: AWS account that owns this cost.
18223+
id: account_id
18224+
type: cost_tag_description
18225+
properties:
18226+
data:
18227+
$ref: "#/components/schemas/CostTagDescriptionUpsertRequestData"
18228+
required:
18229+
- data
18230+
type: object
18231+
CostTagDescriptionUpsertRequestData:
18232+
description: Resource envelope carrying the tag key description being upserted. The `id` is informational; the authoritative tag key is taken from the URL path.
18233+
properties:
18234+
attributes:
18235+
$ref: "#/components/schemas/CostTagDescriptionUpsertRequestDataAttributes"
18236+
id:
18237+
description: Identifier of the tag key the description applies to. Matches the `tag_key` path parameter.
18238+
example: account_id
18239+
type: string
18240+
type:
18241+
$ref: "#/components/schemas/CostTagDescriptionType"
18242+
required:
18243+
- attributes
18244+
- type
18245+
type: object
18246+
CostTagDescriptionUpsertRequestDataAttributes:
18247+
description: Mutable attributes set when creating or updating a Cloud Cost Management tag key description.
18248+
properties:
18249+
cloud:
18250+
description: Cloud provider this description applies to (for example, `aws`). Omit to set the cross-cloud default for the tag key.
18251+
example: aws
18252+
type: string
18253+
description:
18254+
description: The human-readable description for the tag key.
18255+
example: AWS account that owns this cost.
18256+
type: string
18257+
required:
18258+
- description
18259+
type: object
1819718260
CostTagDescriptionsResponse:
1819818261
description: List of Cloud Cost Management tag key descriptions for the organization, optionally filtered to a single cloud provider.
1819918262
example:
@@ -34119,6 +34182,55 @@ components:
3411934182
required:
3412034183
- type
3412134184
type: object
34185+
GenerateCostTagDescriptionResponse:
34186+
description: Response wrapping an AI-generated Cloud Cost Management tag key description.
34187+
example:
34188+
data:
34189+
attributes:
34190+
description: AWS account that owns this cost.
34191+
id: account_id
34192+
type: cost_generated_tag_description
34193+
properties:
34194+
data:
34195+
$ref: "#/components/schemas/GeneratedCostTagDescription"
34196+
required:
34197+
- data
34198+
type: object
34199+
GeneratedCostTagDescription:
34200+
description: AI-generated Cloud Cost Management tag key description returned by the generate endpoint. The result is returned to the client but is not persisted by this endpoint.
34201+
properties:
34202+
attributes:
34203+
$ref: "#/components/schemas/GeneratedCostTagDescriptionAttributes"
34204+
id:
34205+
description: The tag key the AI description was generated for.
34206+
example: account_id
34207+
type: string
34208+
type:
34209+
$ref: "#/components/schemas/GeneratedCostTagDescriptionType"
34210+
required:
34211+
- attributes
34212+
- id
34213+
- type
34214+
type: object
34215+
GeneratedCostTagDescriptionAttributes:
34216+
description: Attributes of an AI-generated Cloud Cost Management tag key description.
34217+
properties:
34218+
description:
34219+
description: The AI-generated description for the tag key.
34220+
example: AWS account that owns this cost.
34221+
type: string
34222+
required:
34223+
- description
34224+
type: object
34225+
GeneratedCostTagDescriptionType:
34226+
default: cost_generated_tag_description
34227+
description: Type of the AI-generated Cloud Cost Management tag description resource.
34228+
enum:
34229+
- cost_generated_tag_description
34230+
example: cost_generated_tag_description
34231+
type: string
34232+
x-enum-varnames:
34233+
- COST_GENERATED_TAG_DESCRIPTION
3412234234
GetActionConnectionResponse:
3412334235
description: The response for found connection
3412434236
properties:
@@ -108672,6 +108784,226 @@ paths:
108672108784
operator: OR
108673108785
permissions:
108674108786
- cloud_cost_management_read
108787+
/api/v2/cost/tag_descriptions/{tag_key}:
108788+
delete:
108789+
description: Delete a Cloud Cost Management tag key description. When `cloud` is omitted, deletes every description for the tag key, falling back to Datadog's global default when available. When `cloud` is provided, deletes only the description scoped to that cloud provider.
108790+
operationId: DeleteCostTagDescriptionByKey
108791+
parameters:
108792+
- description: The tag key whose description is being deleted.
108793+
in: path
108794+
name: tag_key
108795+
required: true
108796+
schema:
108797+
type: string
108798+
- description: Cloud provider to scope the deletion to (for example, `aws`). Omit to delete every description for the tag key.
108799+
in: query
108800+
name: cloud
108801+
required: false
108802+
schema:
108803+
type: string
108804+
responses:
108805+
"204":
108806+
description: No Content
108807+
"400":
108808+
content:
108809+
application/json:
108810+
schema:
108811+
$ref: "#/components/schemas/APIErrorResponse"
108812+
description: Bad Request
108813+
"403":
108814+
content:
108815+
application/json:
108816+
schema:
108817+
$ref: "#/components/schemas/APIErrorResponse"
108818+
description: Forbidden
108819+
"429":
108820+
$ref: "#/components/responses/TooManyRequestsResponse"
108821+
security:
108822+
- apiKeyAuth: []
108823+
appKeyAuth: []
108824+
- AuthZ:
108825+
- cloud_cost_management_write
108826+
summary: Delete a Cloud Cost Management tag description
108827+
tags:
108828+
- Cloud Cost Management
108829+
"x-permission":
108830+
operator: OR
108831+
permissions:
108832+
- cloud_cost_management_write
108833+
get:
108834+
description: Get the Cloud Cost Management description for a single tag key. Use `filter[cloud]` to scope the lookup to a specific cloud provider; when omitted, the response resolves the description in fallback order (cloud-specific organization override, then cloudless organization default, then Datadog's global default).
108835+
operationId: GetCostTagDescriptionByKey
108836+
parameters:
108837+
- description: The tag key whose description is being fetched.
108838+
in: path
108839+
name: tag_key
108840+
required: true
108841+
schema:
108842+
type: string
108843+
- description: Cloud provider to scope the lookup to (for example, `aws`). Omit to use the resolved fallback.
108844+
in: query
108845+
name: filter[cloud]
108846+
required: false
108847+
schema:
108848+
type: string
108849+
responses:
108850+
"200":
108851+
content:
108852+
application/json:
108853+
examples:
108854+
default:
108855+
value:
108856+
data:
108857+
attributes:
108858+
cloud: aws
108859+
created_at: "2026-01-01T12:00:00Z"
108860+
description: AWS account that owns this cost.
108861+
source: human
108862+
tag_key: account_id
108863+
updated_at: "2026-01-01T12:00:00Z"
108864+
id: account_id
108865+
type: cost_tag_description
108866+
schema:
108867+
$ref: "#/components/schemas/CostTagDescriptionResponse"
108868+
description: OK
108869+
"400":
108870+
content:
108871+
application/json:
108872+
schema:
108873+
$ref: "#/components/schemas/APIErrorResponse"
108874+
description: Bad Request
108875+
"403":
108876+
content:
108877+
application/json:
108878+
schema:
108879+
$ref: "#/components/schemas/APIErrorResponse"
108880+
description: Forbidden
108881+
"404":
108882+
content:
108883+
application/json:
108884+
schema:
108885+
$ref: "#/components/schemas/APIErrorResponse"
108886+
description: Not Found
108887+
"429":
108888+
$ref: "#/components/responses/TooManyRequestsResponse"
108889+
security:
108890+
- apiKeyAuth: []
108891+
appKeyAuth: []
108892+
- AuthZ:
108893+
- cloud_cost_management_read
108894+
summary: Get a Cloud Cost Management tag description
108895+
tags:
108896+
- Cloud Cost Management
108897+
"x-permission":
108898+
operator: OR
108899+
permissions:
108900+
- cloud_cost_management_read
108901+
put:
108902+
description: Create or update a Cloud Cost Management tag key description. The new description and optional cloud scoping are supplied in the request body. Omit `cloud` to set a cross-cloud default for the tag key.
108903+
operationId: UpsertCostTagDescriptionByKey
108904+
parameters:
108905+
- description: The tag key whose description is being upserted.
108906+
in: path
108907+
name: tag_key
108908+
required: true
108909+
schema:
108910+
type: string
108911+
requestBody:
108912+
content:
108913+
application/json:
108914+
examples:
108915+
default:
108916+
value:
108917+
data:
108918+
attributes:
108919+
cloud: aws
108920+
description: AWS account that owns this cost.
108921+
id: account_id
108922+
type: cost_tag_description
108923+
schema:
108924+
$ref: "#/components/schemas/CostTagDescriptionUpsertRequest"
108925+
required: true
108926+
responses:
108927+
"204":
108928+
description: No Content
108929+
"400":
108930+
content:
108931+
application/json:
108932+
schema:
108933+
$ref: "#/components/schemas/APIErrorResponse"
108934+
description: Bad Request
108935+
"403":
108936+
content:
108937+
application/json:
108938+
schema:
108939+
$ref: "#/components/schemas/APIErrorResponse"
108940+
description: Forbidden
108941+
"429":
108942+
$ref: "#/components/responses/TooManyRequestsResponse"
108943+
security:
108944+
- apiKeyAuth: []
108945+
appKeyAuth: []
108946+
- AuthZ:
108947+
- cloud_cost_management_write
108948+
summary: Upsert a Cloud Cost Management tag description
108949+
tags:
108950+
- Cloud Cost Management
108951+
"x-permission":
108952+
operator: OR
108953+
permissions:
108954+
- cloud_cost_management_write
108955+
/api/v2/cost/tag_descriptions/{tag_key}/generate:
108956+
get:
108957+
description: Use AI to draft a Cloud Cost Management tag key description based on associated cost data. The generated description is returned in the response and is not persisted by this endpoint; follow up with `UpsertCostTagDescriptionByKey` to save it.
108958+
operationId: GenerateCostTagDescriptionByKey
108959+
parameters:
108960+
- description: The tag key to generate an AI description for.
108961+
in: path
108962+
name: tag_key
108963+
required: true
108964+
schema:
108965+
type: string
108966+
responses:
108967+
"200":
108968+
content:
108969+
application/json:
108970+
examples:
108971+
default:
108972+
value:
108973+
data:
108974+
attributes:
108975+
description: AWS account that owns this cost.
108976+
id: account_id
108977+
type: cost_generated_tag_description
108978+
schema:
108979+
$ref: "#/components/schemas/GenerateCostTagDescriptionResponse"
108980+
description: OK
108981+
"400":
108982+
content:
108983+
application/json:
108984+
schema:
108985+
$ref: "#/components/schemas/APIErrorResponse"
108986+
description: Bad Request
108987+
"403":
108988+
content:
108989+
application/json:
108990+
schema:
108991+
$ref: "#/components/schemas/APIErrorResponse"
108992+
description: Forbidden
108993+
"429":
108994+
$ref: "#/components/responses/TooManyRequestsResponse"
108995+
security:
108996+
- apiKeyAuth: []
108997+
appKeyAuth: []
108998+
- AuthZ:
108999+
- cloud_cost_management_read
109000+
summary: Generate a Cloud Cost Management tag description
109001+
tags:
109002+
- Cloud Cost Management
109003+
"x-permission":
109004+
operator: OR
109005+
permissions:
109006+
- cloud_cost_management_read
108675109007
/api/v2/cost/tag_keys:
108676109008
get:
108677109009
description: List Cloud Cost Management tag keys.

0 commit comments

Comments
 (0)