Skip to content

Commit 78c71a7

Browse files
author
ci.datadog-api-spec
committed
Regenerate client from commit c1ca55e9 of spec repo
1 parent b2de361 commit 78c71a7

21 files changed

+1231
-115
lines changed

‎.apigentools-info

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,13 +4,13 @@
44
"spec_versions": {
55
"v1": {
66
"apigentools_version": "1.6.6",
7-
"regenerated": "2025-05-16 13:56:33.962104",
8-
"spec_repo_commit": "dac51bc6"
7+
"regenerated": "2025-05-19 16:15:54.805179",
8+
"spec_repo_commit": "c1ca55e9"
99
},
1010
"v2": {
1111
"apigentools_version": "1.6.6",
12-
"regenerated": "2025-05-16 13:56:34.055440",
13-
"spec_repo_commit": "dac51bc6"
12+
"regenerated": "2025-05-19 16:15:54.822687",
13+
"spec_repo_commit": "c1ca55e9"
1414
}
1515
}
1616
}

‎.generator/schemas/v2/openapi.yaml

Lines changed: 163 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -2154,6 +2154,89 @@ components:
21542154
- id
21552155
- base_severity
21562156
type: object
2157+
AlertEventCustomAttributes:
2158+
additionalProperties: false
2159+
description: Object representing custom alert event attributes.
2160+
properties:
2161+
custom:
2162+
$ref: '#/components/schemas/AlertEventCustomAttributesCustom'
2163+
links:
2164+
$ref: '#/components/schemas/AlertEventCustomAttributesLinks'
2165+
priority:
2166+
$ref: '#/components/schemas/AlertEventCustomAttributesPriority'
2167+
status:
2168+
$ref: '#/components/schemas/AlertEventCustomAttributesStatus'
2169+
type: object
2170+
AlertEventCustomAttributesCustom:
2171+
additionalProperties: {}
2172+
description: Custom attributes. Support up to 100 properties and a maximum nesting
2173+
depth of 10 levels.
2174+
example: {}
2175+
type: object
2176+
AlertEventCustomAttributesLinks:
2177+
description: The links related to the event.
2178+
items:
2179+
$ref: '#/components/schemas/AlertEventCustomAttributesLinksItems'
2180+
maxItems: 20
2181+
minItems: 1
2182+
type: array
2183+
AlertEventCustomAttributesLinksItems:
2184+
description: A link.
2185+
properties:
2186+
category:
2187+
$ref: '#/components/schemas/AlertEventCustomAttributesLinksItemsCategory'
2188+
title:
2189+
description: The title of the link. Limited to 300 characters.
2190+
example: Runbook Link
2191+
maxLength: 300
2192+
type: string
2193+
url:
2194+
description: The URL of the link. Limited to 2048 characters.
2195+
example: https://app.datadoghq.com/runbook
2196+
maxLength: 2048
2197+
type: string
2198+
required:
2199+
- url
2200+
- category
2201+
type: object
2202+
AlertEventCustomAttributesLinksItemsCategory:
2203+
description: The category of the link.
2204+
enum:
2205+
- runbook
2206+
example: runbook
2207+
type: string
2208+
x-enum-varnames:
2209+
- RUNBOOK
2210+
AlertEventCustomAttributesPriority:
2211+
description: The priority of the alert.
2212+
enum:
2213+
- '1'
2214+
- '2'
2215+
- '3'
2216+
- '4'
2217+
- '5'
2218+
example: '1'
2219+
type: string
2220+
x-enum-varnames:
2221+
- PRIORITY_ONE
2222+
- PRIORITY_TWO
2223+
- PRIORITY_THREE
2224+
- PRIORITY_FOUR
2225+
- PRIORITY_FIVE
2226+
AlertEventCustomAttributesStatus:
2227+
description: The status of the alert.
2228+
enum:
2229+
- info
2230+
- warn
2231+
- error
2232+
- ok
2233+
example: warn
2234+
type: string
2235+
x-enum-varnames:
2236+
- INFO
2237+
- WARN
2238+
- ERROR
2239+
- OK
21572240
Annotation:
21582241
description: A list of annotations used in the workflow. These are like sticky
21592242
notes for your workflow!
@@ -6846,6 +6929,7 @@ components:
68466929
type: integer
68476930
type: object
68486931
ChangeEventCustomAttributes:
6932+
additionalProperties: false
68496933
description: Object representing custom change event attributes.
68506934
properties:
68516935
author:
@@ -14207,28 +14291,34 @@ components:
1420714291
type: string
1420814292
type: object
1420914293
EventCategory:
14210-
description: Event category to identify the type of event. Only the value `change`
14211-
is supported. Support for other categories are coming. please reach out to
14212-
datadog support if you're interested.
14294+
description: Event category to identify the type of event. For example, `change`
14295+
or `alert`.
1421314296
enum:
1421414297
- change
14298+
- alert
1421514299
example: change
1421614300
type: string
1421714301
x-enum-varnames:
1421814302
- CHANGE
14303+
- ALERT
1421914304
EventCreateRequest:
1422014305
description: Object representing an event creation request.
1422114306
properties:
1422214307
attributes:
1422314308
$ref: '#/components/schemas/EventPayload'
1422414309
type:
1422514310
$ref: '#/components/schemas/EventCreateRequestType'
14311+
required:
14312+
- type
14313+
- attributes
1422614314
type: object
1422714315
EventCreateRequestPayload:
1422814316
description: Payload for creating an event.
1422914317
properties:
1423014318
data:
1423114319
$ref: '#/components/schemas/EventCreateRequest'
14320+
required:
14321+
- data
1423214322
type: object
1423314323
EventCreateRequestType:
1423414324
description: Entity type.
@@ -14264,28 +14354,42 @@ components:
1426414354
EventCreateResponseAttributesAttributesEvt:
1426514355
description: JSON object of event system attributes.
1426614356
properties:
14267-
id:
14268-
description: Event id
14357+
uid:
14358+
description: A unique identifier for the event. You can use this ID to query
14359+
or reference the event in the V2 endpoint.
1426914360
type: string
1427014361
type: object
1427114362
EventCreateResponsePayload:
1427214363
description: Response containing information about created event.
1427314364
properties:
1427414365
data:
1427514366
$ref: '#/components/schemas/EventCreateResponse'
14367+
links:
14368+
$ref: '#/components/schemas/EventCreateResponsePayloadLinks'
14369+
type: object
14370+
EventCreateResponsePayloadLinks:
14371+
description: Links attributes.
14372+
properties:
14373+
self:
14374+
description: The URL of the event. This link is only functional when using
14375+
the default subdomain.
14376+
type: string
1427614377
type: object
1427714378
EventPayload:
1427814379
description: Event attributes.
1427914380
properties:
1428014381
aggregation_key:
1428114382
description: An arbitrary string to use for aggregation when correlating
1428214383
events. Limited to 100 characters.
14384+
example: aggregation_key_123
1428314385
maxLength: 100
1428414386
type: string
1428514387
attributes:
1428614388
$ref: '#/components/schemas/EventPayloadAttributes'
1428714389
category:
1428814390
$ref: '#/components/schemas/EventCategory'
14391+
integration_id:
14392+
$ref: '#/components/schemas/EventPayloadIntegrationId'
1428914393
message:
1429014394
description: The body of the event. Limited to 4000 characters.
1429114395
example: payment_processed feature flag has been enabled
@@ -14299,7 +14403,10 @@ components:
1429914403
- env:test
1430014404
items:
1430114405
description: A tag.
14406+
maxLength: 200
1430214407
type: string
14408+
maxItems: 100
14409+
minItems: 1
1430314410
type: array
1430414411
timestamp:
1430514412
description: 'Timestamp when the event occurred. Must follow [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html)
@@ -14325,6 +14432,16 @@ components:
1432514432
event category.
1432614433
oneOf:
1432714434
- $ref: '#/components/schemas/ChangeEventCustomAttributes'
14435+
- $ref: '#/components/schemas/AlertEventCustomAttributes'
14436+
EventPayloadIntegrationId:
14437+
description: Integration IDs sourced from integration manifests. Currently,
14438+
only `custom-events` is supported.
14439+
enum:
14440+
- custom-events
14441+
example: custom-events
14442+
type: string
14443+
x-enum-varnames:
14444+
- CUSTOM_EVENTS
1432814445
EventPriority:
1432914446
description: The priority of the event's monitor. For example, `normal` or `low`.
1433014447
enum:
@@ -45705,9 +45822,12 @@ paths:
4570545822
- events_read
4570645823
post:
4570745824
description: "This endpoint allows you to post events.\n\n\u2705 **Only events
45708-
with the `change` category** are in General Availability. See [Change Tracking](https://docs.datadoghq.com/change_tracking)
45825+
with the `change` or `alert` category** are in General Availability. For change
45826+
events, see [Change Tracking](https://docs.datadoghq.com/change_tracking)
4570945827
for more details.\n\n\u274C For use cases involving other event categories,
45710-
please use the V1 endpoint."
45828+
please use the V1 endpoint.\n\u274C Currently, notifications are not supported
45829+
for events sent to this endpoint, please use the V1 endpoint for notification
45830+
functionality."
4571145831
operationId: CreateEvent
4571245832
requestBody:
4571345833
content:
@@ -45717,6 +45837,7 @@ paths:
4571745837
value:
4571845838
data:
4571945839
attributes:
45840+
aggregation_key: aggregation_key_123
4572045841
attributes:
4572145842
author:
4572245843
name: datadog@datadog.com
@@ -45745,17 +45866,19 @@ paths:
4574545866
rule:
4574645867
datacenter: devcycle.us1.prod
4574745868
category: change
45869+
integration_id: custom-events
4574845870
message: payment_processed feature flag has been enabled
4574945871
tags:
4575045872
- env:test
45873+
timestamp: '2020-01-01T01:30:15.010000Z'
4575145874
title: payment_processed feature flag updated
4575245875
type: event
4575345876
schema:
4575445877
$ref: '#/components/schemas/EventCreateRequestPayload'
4575545878
description: Event request object
4575645879
required: true
4575745880
responses:
45758-
'200':
45881+
'202':
4575945882
content:
4576045883
application/json:
4576145884
schema:
@@ -45778,6 +45901,38 @@ paths:
4577845901
security:
4577945902
- apiKeyAuth: []
4578045903
appKeyAuth: []
45904+
servers:
45905+
- url: https://{subdomain}.{site}
45906+
variables:
45907+
site:
45908+
default: datadoghq.com
45909+
description: The regional site for customers.
45910+
enum:
45911+
- datadoghq.com
45912+
- us3.datadoghq.com
45913+
- us5.datadoghq.com
45914+
- ap1.datadoghq.com
45915+
- datadoghq.eu
45916+
- ddog-gov.com
45917+
subdomain:
45918+
default: event-management-intake
45919+
description: The subdomain where the API is deployed.
45920+
- url: '{protocol}://{name}'
45921+
variables:
45922+
name:
45923+
default: event-management-intake.datadoghq.com
45924+
description: Full site DNS name.
45925+
protocol:
45926+
default: https
45927+
description: The protocol for accessing the API.
45928+
- url: https://{subdomain}.{site}
45929+
variables:
45930+
site:
45931+
default: datadoghq.com
45932+
description: Any Datadog deployment.
45933+
subdomain:
45934+
default: event-management-intake
45935+
description: The subdomain where the API is deployed.
4578145936
summary: Post an event
4578245937
tags:
4578345938
- Events

‎examples/v2/events/CreateEvent.java

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -17,6 +17,7 @@
1717
import com.datadog.api.client.v2.model.EventCreateResponsePayload;
1818
import com.datadog.api.client.v2.model.EventPayload;
1919
import com.datadog.api.client.v2.model.EventPayloadAttributes;
20+
import com.datadog.api.client.v2.model.EventPayloadIntegrationId;
2021
import java.util.Collections;
2122
import java.util.Map;
2223

@@ -31,6 +32,7 @@ public static void main(String[] args) {
3132
new EventCreateRequest()
3233
.attributes(
3334
new EventPayload()
35+
.aggregationKey("aggregation_key_123")
3436
.attributes(
3537
new EventPayloadAttributes(
3638
new ChangeEventCustomAttributes()
@@ -76,6 +78,7 @@ public static void main(String[] args) {
7678
"rule",
7779
"{'datacenter': 'devcycle.us1.prod'}")))))
7880
.category(EventCategory.CHANGE)
81+
.integrationId(EventPayloadIntegrationId.CUSTOM_EVENTS)
7982
.message("payment_processed feature flag has been enabled")
8083
.tags(Collections.singletonList("env:test"))
8184
.title("payment_processed feature flag updated"))

0 commit comments

Comments
 (0)