@@ -3951,6 +3951,243 @@ components:
3951
3951
format: int64
3952
3952
type: integer
3953
3953
type: object
3954
+ ChangeEvent:
3955
+ description: Event attributes.
3956
+ properties:
3957
+ aggregation_key:
3958
+ description: 'An arbitrary string to use for aggregation. Limited to 100
3959
+ characters.
3960
+
3961
+ If you specify a key, all events using that key are grouped together in
3962
+ the Event Stream.'
3963
+ maxLength: 100
3964
+ type: string
3965
+ attributes:
3966
+ $ref: '#/components/schemas/ChangeEventCustomAttributes'
3967
+ category:
3968
+ $ref: '#/components/schemas/ChangeEventCategory'
3969
+ message:
3970
+ description: The body of the event. Limited to 4000 characters.
3971
+ example: payment_processed feature flag has been enabled
3972
+ maxLength: 4000
3973
+ type: string
3974
+ tags:
3975
+ description: 'A list of tags to apply to the event.
3976
+
3977
+ Refer to [Tags docs](https://docs.datadoghq.com/getting_started/tagging/).'
3978
+ example:
3979
+ - environment:test
3980
+ items:
3981
+ description: A tag.
3982
+ type: string
3983
+ type: array
3984
+ timestamp:
3985
+ description: 'Timestamp in which the event occurred. Must follow [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html)
3986
+ format.
3987
+
3988
+ For example `"2017-01-15T01:30:15.010000Z"`.
3989
+
3990
+ Defaults to now. Limited to values no older than 18 hours.'
3991
+ type: string
3992
+ title:
3993
+ description: The event title. Limited to 500 characters.
3994
+ example: payment_processed feature flag updated
3995
+ maxLength: 500
3996
+ type: string
3997
+ required:
3998
+ - title
3999
+ - category
4000
+ - attributes
4001
+ type: object
4002
+ ChangeEventCategory:
4003
+ description: Event category to identify the type of event. Only the value `change`
4004
+ is supported.
4005
+ enum:
4006
+ - change
4007
+ example: change
4008
+ type: string
4009
+ x-enum-varnames:
4010
+ - CHANGE
4011
+ ChangeEventCreateRequest:
4012
+ description: Object representing an event.
4013
+ properties:
4014
+ attributes:
4015
+ $ref: '#/components/schemas/ChangeEvent'
4016
+ type:
4017
+ $ref: '#/components/schemas/ChangeEventCreateRequestType'
4018
+ type: object
4019
+ ChangeEventCreateRequestPayload:
4020
+ description: Create an event.
4021
+ properties:
4022
+ data:
4023
+ $ref: '#/components/schemas/ChangeEventCreateRequest'
4024
+ type: object
4025
+ ChangeEventCreateRequestType:
4026
+ description: Entity type.
4027
+ enum:
4028
+ - event
4029
+ example: event
4030
+ type: string
4031
+ x-enum-varnames:
4032
+ - EVENT
4033
+ ChangeEventCreateResponse:
4034
+ description: Object containing an event response.
4035
+ properties:
4036
+ attributes:
4037
+ $ref: '#/components/schemas/ChangeEventCreateResponseAttributes'
4038
+ type:
4039
+ description: Event type
4040
+ example: event
4041
+ type: string
4042
+ type: object
4043
+ ChangeEventCreateResponseAttributes:
4044
+ description: Event response attributes.
4045
+ properties:
4046
+ attributes:
4047
+ $ref: '#/components/schemas/ChangeEventCreateResponseAttributesAttributes'
4048
+ type: object
4049
+ ChangeEventCreateResponseAttributesAttributes:
4050
+ description: The definition of `ChangeEventCreateResponseAttributesAttributes`
4051
+ object.
4052
+ properties:
4053
+ evt:
4054
+ $ref: '#/components/schemas/ChangeEventCreateResponseAttributesAttributesEvt'
4055
+ type: object
4056
+ ChangeEventCreateResponseAttributesAttributesEvt:
4057
+ description: The definition of `ChangeEventCreateResponseAttributesAttributesEvt`
4058
+ object.
4059
+ properties:
4060
+ id:
4061
+ description: Event id
4062
+ type: string
4063
+ type: object
4064
+ ChangeEventCreateResponsePayload:
4065
+ description: Response containing information about created event.
4066
+ properties:
4067
+ data:
4068
+ $ref: '#/components/schemas/ChangeEventCreateResponse'
4069
+ type: object
4070
+ ChangeEventCustomAttributes:
4071
+ description: Object representing custom event attributes.
4072
+ properties:
4073
+ author:
4074
+ $ref: '#/components/schemas/ChangeEventCustomAttributesAuthor'
4075
+ change_metadata:
4076
+ additionalProperties: {}
4077
+ description: Free form object with any related information of the `change`
4078
+ event.
4079
+ example:
4080
+ dd:
4081
+ team: datadog_team
4082
+
4083
+ user_id: datadog_user_id
4084
+ user_name: datadog_username
4085
+ resource_link: datadog.com/feature/fallback_payments_test
4086
+ type: object
4087
+ changed_resource:
4088
+ $ref: '#/components/schemas/ChangeEventCustomAttributesChangedResource'
4089
+ impacted_resources:
4090
+ description: 'A list of resources impacted by this change. It is recommended
4091
+ to provide an impacted resource to display
4092
+
4093
+ the change event at the right location. Only resources of type `service`
4094
+ are supported.'
4095
+ example:
4096
+ - name: payments_api
4097
+ type: service
4098
+ items:
4099
+ $ref: '#/components/schemas/ChangeEventCustomAttributesImpactedResourcesItems'
4100
+ type: array
4101
+ new_value:
4102
+ additionalProperties: {}
4103
+ description: Free form object to track new value of the changed resource.
4104
+ example:
4105
+ enabled: true
4106
+ percentage: 50%
4107
+ rule:
4108
+ datacenter: devcycle.us1.prod
4109
+ type: object
4110
+ prev_value:
4111
+ additionalProperties: {}
4112
+ description: Free form object to track previous value of the changed resource.
4113
+ example:
4114
+ enabled: true
4115
+ percentage: 10%
4116
+ rule:
4117
+ datacenter: devcycle.us1.prod
4118
+ type: object
4119
+ required:
4120
+ - changed_resource
4121
+ type: object
4122
+ ChangeEventCustomAttributesAuthor:
4123
+ description: Object representing the entity which made the change. Optional
4124
+ field but if provided should include `type` and `name`.
4125
+ properties:
4126
+ name:
4127
+ description: Author's name. Limited to 128 characters.
4128
+
4129
+ maxLength: 128
4130
+ type: string
4131
+ type:
4132
+ $ref: '#/components/schemas/ChangeEventCustomAttributesAuthorType'
4133
+ required:
4134
+ - name
4135
+ - type
4136
+ type: object
4137
+ ChangeEventCustomAttributesAuthorType:
4138
+ description: Author's type.
4139
+ enum:
4140
+ - user
4141
+ - system
4142
+ example: user
4143
+ type: string
4144
+ x-enum-varnames:
4145
+ - USER
4146
+ - SYSTEM
4147
+ ChangeEventCustomAttributesChangedResource:
4148
+ description: Object representing a uniquely identified resource. Only the resource
4149
+ type `feature_flag` is supported.
4150
+ properties:
4151
+ name:
4152
+ description: Resource's name.
4153
+ example: fallback_payments_test
4154
+ type: string
4155
+ type:
4156
+ $ref: '#/components/schemas/ChangeEventCustomAttributesChangedResourceType'
4157
+ required:
4158
+ - type
4159
+ - name
4160
+ type: object
4161
+ ChangeEventCustomAttributesChangedResourceType:
4162
+ description: Resource's type.
4163
+ enum:
4164
+ - feature_flag
4165
+ example: feature_flag
4166
+ type: string
4167
+ x-enum-varnames:
4168
+ - FEATURE_FLAG
4169
+ ChangeEventCustomAttributesImpactedResourcesItems:
4170
+ description: Object representing a uniquely identified resource. Only the resource
4171
+ type `service` is supported.
4172
+ properties:
4173
+ name:
4174
+ description: Resource's name.
4175
+ example: payments_api
4176
+ type: string
4177
+ type:
4178
+ $ref: '#/components/schemas/ChangeEventCustomAttributesImpactedResourcesItemsType'
4179
+ required:
4180
+ - type
4181
+ - name
4182
+ type: object
4183
+ ChangeEventCustomAttributesImpactedResourcesItemsType:
4184
+ description: Resource's type.
4185
+ enum:
4186
+ - service
4187
+ example: service
4188
+ type: string
4189
+ x-enum-varnames:
4190
+ - SERVICE
3954
4191
ChargebackBreakdown:
3955
4192
description: Charges breakdown.
3956
4193
properties:
@@ -29664,6 +29901,47 @@ paths:
29664
29901
operator: OR
29665
29902
permissions:
29666
29903
- events_read
29904
+ post:
29905
+ description: This endpoint allows you to post events. Only events with `change`
29906
+ category are supported.
29907
+ operationId: CreateEvent
29908
+ requestBody:
29909
+ content:
29910
+ application/json:
29911
+ schema:
29912
+ $ref: '#/components/schemas/ChangeEventCreateRequestPayload'
29913
+ description: Event request object
29914
+ required: true
29915
+ responses:
29916
+ '200':
29917
+ content:
29918
+ application/json:
29919
+ schema:
29920
+ $ref: '#/components/schemas/ChangeEventCreateResponsePayload'
29921
+ description: OK
29922
+ '400':
29923
+ content:
29924
+ application/json:
29925
+ schema:
29926
+ $ref: '#/components/schemas/JSONAPIErrorResponse'
29927
+ description: Bad request
29928
+ '403':
29929
+ content:
29930
+ application/json:
29931
+ schema:
29932
+ $ref: '#/components/schemas/JSONAPIErrorResponse'
29933
+ description: Forbidden
29934
+ '429':
29935
+ $ref: '#/components/responses/TooManyRequestsResponse'
29936
+ security:
29937
+ - apiKeyAuth: []
29938
+ summary: Post a change event
29939
+ tags:
29940
+ - Events
29941
+ x-codegen-request-body-name: body
29942
+ x-unstable: '**Note**: This endpoint is in **Preview**.
29943
+
29944
+ If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
29667
29945
/api/v2/events/search:
29668
29946
post:
29669
29947
description: 'List endpoint returns events that match an events search query.
0 commit comments