Regenerate client from commit af0cd40 of spec repo

Author: ci.datadog-api-spec

.generator/schemas/v2/openapi.yaml

@@ -17289,6 +17289,76 @@ components:
       - score
       - severity
       type: object
+    Email:
+      description: On-Call User Email.
+      example:
+        data:
+          attributes:
+            active: true
+            address: [email protected]
+            alias: ''
+            blocked: false
+            created_at: '2024-04-16T23:38:50.388642Z'
+            formats:
+            - html
+            modified_at: '2024-04-16T23:38:50.388642Z'
+          id: 45cd9fe5-dd96-42ad-83de-2242ea9f6efd
+          type: emails
+      properties:
+        data:
+          $ref: '#/components/schemas/EmailData'
+      type: object
+    EmailAttributes:
+      description: Attributes for an on-call email.
+      properties:
+        active:
+          description: Whether the email is currently active.
+          type: boolean
+        address:
+          description: Email address.
+          type: string
+        alias:
+          description: Optional display alias for the email.
+          type: string
+        blocked:
+          description: Whether the email is blocked.
+          type: boolean
+        created_at:
+          description: Creation time of the email resource.
+          format: date-time
+          type: string
+        formats:
+          description: Preferred content formats for notifications.
+          items:
+            type: string
+          type: array
+        modified_at:
+          description: Last modification time of the email resource.
+          format: date-time
+          type: string
+      type: object
+    EmailData:
+      description: Data for an on-call email resource.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/EmailAttributes'
+        id:
+          description: The email's unique identifier.
+          type: string
+        type:
+          $ref: '#/components/schemas/EmailType'
+      required:
+      - type
+      type: object
+    EmailType:
+      default: emails
+      description: Indicates that the resource is of type 'emails'.
+      enum:
+      - emails
+      example: emails
+      type: string
+      x-enum-varnames:
+      - EMAILS
     Enabled:
       description: Field used to enable or disable the rule.
       example: true
@@ -70837,6 +70907,48 @@ paths:
         operator: AND
         permissions:
         - on_call_write
+  /api/v2/on-call/users/{user_id}/notification-channels/emails:
+    post:
+      description: Create a new email notification channel for an on-call user
+      operationId: CreateUserEmailNotificationChannel
+      parameters:
+      - description: The user ID
+        in: path
+        name: user_id
+        required: true
+        schema:
+          example: 00000000-0000-0000-0000-000000000000
+          type: string
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/Email'
+        required: true
+      responses:
+        '201':
+          description: Created
+        '400':
+          $ref: '#/components/responses/BadRequestResponse'
+        '401':
+          $ref: '#/components/responses/UnauthorizedResponse'
+        '403':
+          $ref: '#/components/responses/ForbiddenResponse'
+        '404':
+          $ref: '#/components/responses/NotFoundResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ: []
+      summary: Create email notification channel for user
+      tags:
+      - On-Call
+      x-permission:
+        operator: AND
+        permissions:
+        - on_call_admin
   /api/v2/org_configs:
     get:
       description: Returns all Org Configs (name, description, and value).

api/datadogV2/api_on_call.go

@@ -231,6 +231,77 @@ func (a *OnCallApi) CreateOnCallSchedule(ctx _context.Context, body ScheduleCrea
 	return localVarReturnValue, localVarHTTPResponse, nil
 }
 
+// CreateUserEmailNotificationChannel Create email notification channel for user.
+// Create a new email notification channel for an on-call user
+func (a *OnCallApi) CreateUserEmailNotificationChannel(ctx _context.Context, userId string, body Email) (*_nethttp.Response, error) {
+	var (
+		localVarHTTPMethod = _nethttp.MethodPost
+		localVarPostBody   interface{}
+	)
+
+	localBasePath, err := a.Client.Cfg.ServerURLWithContext(ctx, "v2.OnCallApi.CreateUserEmailNotificationChannel")
+	if err != nil {
+		return nil, datadog.GenericOpenAPIError{ErrorMessage: err.Error()}
+	}
+
+	localVarPath := localBasePath + "/api/v2/on-call/users/{user_id}/notification-channels/emails"
+	localVarPath = datadog.ReplacePathParameter(localVarPath, "{user_id}", _neturl.PathEscape(datadog.ParameterToString(userId, "")))
+
+	localVarHeaderParams := make(map[string]string)
+	localVarQueryParams := _neturl.Values{}
+	localVarFormParams := _neturl.Values{}
+	localVarHeaderParams["Content-Type"] = "application/json"
+	localVarHeaderParams["Accept"] = "*/*"
+
+	// body params
+	localVarPostBody = &body
+	if a.Client.Cfg.DelegatedTokenConfig != nil {
+		err = datadog.UseDelegatedTokenAuth(ctx, &localVarHeaderParams, a.Client.Cfg.DelegatedTokenConfig)
+		if err != nil {
+			return nil, err
+		}
+	} else {
+		datadog.SetAuthKeys(
+			ctx,
+			&localVarHeaderParams,
+			[2]string{"apiKeyAuth", "DD-API-KEY"},
+			[2]string{"appKeyAuth", "DD-APPLICATION-KEY"},
+		)
+	}
+	req, err := a.Client.PrepareRequest(ctx, localVarPath, localVarHTTPMethod, localVarPostBody, localVarHeaderParams, localVarQueryParams, localVarFormParams, nil)
+	if err != nil {
+		return nil, err
+	}
+
+	localVarHTTPResponse, err := a.Client.CallAPI(req)
+	if err != nil || localVarHTTPResponse == nil {
+		return localVarHTTPResponse, err
+	}
+
+	localVarBody, err := datadog.ReadBody(localVarHTTPResponse)
+	if err != nil {
+		return localVarHTTPResponse, err
+	}
+
+	if localVarHTTPResponse.StatusCode >= 300 {
+		newErr := datadog.GenericOpenAPIError{
+			ErrorBody:    localVarBody,
+			ErrorMessage: localVarHTTPResponse.Status,
+		}
+		if localVarHTTPResponse.StatusCode == 400 || localVarHTTPResponse.StatusCode == 401 || localVarHTTPResponse.StatusCode == 403 || localVarHTTPResponse.StatusCode == 404 || localVarHTTPResponse.StatusCode == 429 {
+			var v APIErrorResponse
+			err = a.Client.Decode(&v, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
+			if err != nil {
+				return localVarHTTPResponse, newErr
+			}
+			newErr.ErrorModel = v
+		}
+		return localVarHTTPResponse, newErr
+	}
+
+	return localVarHTTPResponse, nil
+}
+
 // DeleteOnCallEscalationPolicy Delete On-Call escalation policy.
 // Delete an On-Call escalation policy
 func (a *OnCallApi) DeleteOnCallEscalationPolicy(ctx _context.Context, policyId string) (*_nethttp.Response, error) {

api/datadogV2/doc.go

@@ -406,6 +406,7 @@
 //   - [OktaIntegrationApi.UpdateOktaAccount]
 //   - [On-CallApi.CreateOnCallEscalationPolicy]
 //   - [On-CallApi.CreateOnCallSchedule]
+//   - [On-CallApi.CreateUserEmailNotificationChannel]
 //   - [On-CallApi.DeleteOnCallEscalationPolicy]
 //   - [On-CallApi.DeleteOnCallSchedule]
 //   - [On-CallApi.GetOnCallEscalationPolicy]

api/datadogV2/model_email.go

@@ -0,0 +1,111 @@
+// Unless explicitly stated otherwise all files in this repository are licensed under the Apache-2.0 License.
+// This product includes software developed at Datadog (https://www.datadoghq.com/).
+// Copyright 2019-Present Datadog, Inc.
+
+package datadogV2
+
+import (
+	"github.com/DataDog/datadog-api-client-go/v2/api/datadog"
+)
+
+// Email On-Call User Email.
+type Email struct {
+	// Data for an on-call email resource.
+	Data *EmailData `json:"data,omitempty"`
+	// UnparsedObject contains the raw value of the object if there was an error when deserializing into the struct
+	UnparsedObject       map[string]interface{} `json:"-"`
+	AdditionalProperties map[string]interface{} `json:"-"`
+}
+
+// NewEmail instantiates a new Email object.
+// This constructor will assign default values to properties that have it defined,
+// and makes sure properties required by API are set, but the set of arguments
+// will change when the set of required properties is changed.
+func NewEmail() *Email {
+	this := Email{}
+	return &this
+}
+
+// NewEmailWithDefaults instantiates a new Email object.
+// This constructor will only assign default values to properties that have it defined,
+// but it doesn't guarantee that properties required by API are set.
+func NewEmailWithDefaults() *Email {
+	this := Email{}
+	return &this
+}
+
+// GetData returns the Data field value if set, zero value otherwise.
+func (o *Email) GetData() EmailData {
+	if o == nil || o.Data == nil {
+		var ret EmailData
+		return ret
+	}
+	return *o.Data
+}
+
+// GetDataOk returns a tuple with the Data field value if set, nil otherwise
+// and a boolean to check if the value has been set.
+func (o *Email) GetDataOk() (*EmailData, bool) {
+	if o == nil || o.Data == nil {
+		return nil, false
+	}
+	return o.Data, true
+}
+
+// HasData returns a boolean if a field has been set.
+func (o *Email) HasData() bool {
+	return o != nil && o.Data != nil
+}
+
+// SetData gets a reference to the given EmailData and assigns it to the Data field.
+func (o *Email) SetData(v EmailData) {
+	o.Data = &v
+}
+
+// MarshalJSON serializes the struct using spec logic.
+func (o Email) MarshalJSON() ([]byte, error) {
+	toSerialize := map[string]interface{}{}
+	if o.UnparsedObject != nil {
+		return datadog.Marshal(o.UnparsedObject)
+	}
+	if o.Data != nil {
+		toSerialize["data"] = o.Data
+	}
+
+	for key, value := range o.AdditionalProperties {
+		toSerialize[key] = value
+	}
+	return datadog.Marshal(toSerialize)
+}
+
+// UnmarshalJSON deserializes the given payload.
+func (o *Email) UnmarshalJSON(bytes []byte) (err error) {
+	all := struct {
+		Data *EmailData `json:"data,omitempty"`
+	}{}
+	if err = datadog.Unmarshal(bytes, &all); err != nil {
+		return datadog.Unmarshal(bytes, &o.UnparsedObject)
+	}
+	additionalProperties := make(map[string]interface{})
+	if err = datadog.Unmarshal(bytes, &additionalProperties); err == nil {
+		datadog.DeleteKeys(additionalProperties, &[]string{"data"})
+	} else {
+		return err
+	}
+
+	hasInvalidField := false
+	if all.Data != nil && all.Data.UnparsedObject != nil && o.UnparsedObject == nil {
+		hasInvalidField = true
+	}
+	o.Data = all.Data
+
+	if len(additionalProperties) > 0 {
+		o.AdditionalProperties = additionalProperties
+	}
+
+	if hasInvalidField {
+		return datadog.Unmarshal(bytes, &o.UnparsedObject)
+	}
+
+	return nil
+}