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: john.doe@datadoghq.com
+            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).

examples/v2/on-call/CreateUserEmailNotificationChannel.java

@@ -0,0 +1,44 @@
+// Create email notification channel for user returns "Created" response
+
+import com.datadog.api.client.ApiClient;
+import com.datadog.api.client.ApiException;
+import com.datadog.api.client.v2.api.OnCallApi;
+import com.datadog.api.client.v2.model.Email;
+import com.datadog.api.client.v2.model.EmailAttributes;
+import com.datadog.api.client.v2.model.EmailData;
+import com.datadog.api.client.v2.model.EmailType;
+import java.time.OffsetDateTime;
+import java.util.Collections;
+
+public class Example {
+  public static void main(String[] args) {
+    ApiClient defaultClient = ApiClient.getDefaultApiClient();
+    OnCallApi apiInstance = new OnCallApi(defaultClient);
+
+    Email body =
+        new Email()
+            .data(
+                new EmailData()
+                    .attributes(
+                        new EmailAttributes()
+                            .active(true)
+                            .address("john.doe@datadoghq.com")
+                            .alias("")
+                            .blocked(false)
+                            .createdAt(OffsetDateTime.parse("2024-04-16T23:38:50.388642Z"))
+                            .formats(Collections.singletonList("html"))
+                            .modifiedAt(OffsetDateTime.parse("2024-04-16T23:38:50.388642Z")))
+                    .id("45cd9fe5-dd96-42ad-83de-2242ea9f6efd")
+                    .type(EmailType.EMAILS));
+
+    try {
+      apiInstance.createUserEmailNotificationChannel("00000000-0000-0000-0000-000000000000", body);
+    } catch (ApiException e) {
+      System.err.println("Exception when calling OnCallApi#createUserEmailNotificationChannel");
+      System.err.println("Status code: " + e.getCode());
+      System.err.println("Reason: " + e.getResponseBody());
+      System.err.println("Response headers: " + e.getResponseHeaders());
+      e.printStackTrace();
+    }
+  }
+}

src/main/java/com/datadog/api/client/v2/api/OnCallApi.java

@@ -4,6 +4,7 @@
 import com.datadog.api.client.ApiException;
 import com.datadog.api.client.ApiResponse;
 import com.datadog.api.client.Pair;
+import com.datadog.api.client.v2.model.Email;
 import com.datadog.api.client.v2.model.EscalationPolicy;
 import com.datadog.api.client.v2.model.EscalationPolicyCreateRequest;
 import com.datadog.api.client.v2.model.EscalationPolicyUpdateRequest;
@@ -452,6 +453,169 @@ public CompletableFuture<ApiResponse<Schedule>> createOnCallScheduleWithHttpInfo
         new GenericType<Schedule>() {});
   }
 
+  /**
+   * Create email notification channel for user.
+   *
+   * <p>See {@link #createUserEmailNotificationChannelWithHttpInfo}.
+   *
+   * @param userId The user ID (required)
+   * @param body (required)
+   * @throws ApiException if fails to make API call
+   */
+  public void createUserEmailNotificationChannel(String userId, Email body) throws ApiException {
+    createUserEmailNotificationChannelWithHttpInfo(userId, body);
+  }
+
+  /**
+   * Create email notification channel for user.
+   *
+   * <p>See {@link #createUserEmailNotificationChannelWithHttpInfoAsync}.
+   *
+   * @param userId The user ID (required)
+   * @param body (required)
+   * @return CompletableFuture
+   */
+  public CompletableFuture<Void> createUserEmailNotificationChannelAsync(
+      String userId, Email body) {
+    return createUserEmailNotificationChannelWithHttpInfoAsync(userId, body)
+        .thenApply(
+            response -> {
+              return response.getData();
+            });
+  }
+
+  /**
+   * Create a new email notification channel for an on-call user
+   *
+   * @param userId The user ID (required)
+   * @param body (required)
+   * @return ApiResponse&lt;Void&gt;
+   * @throws ApiException if fails to make API call
+   * @http.response.details
+   *     <table border="1">
+   *    <caption>Response details</caption>
+   *       <tr><td> Status Code </td><td> Description </td><td> Response Headers </td></tr>
+   *       <tr><td> 201 </td><td> Created </td><td>  -  </td></tr>
+   *       <tr><td> 400 </td><td> Bad Request </td><td>  -  </td></tr>
+   *       <tr><td> 401 </td><td> Unauthorized </td><td>  -  </td></tr>
+   *       <tr><td> 403 </td><td> Forbidden </td><td>  -  </td></tr>
+   *       <tr><td> 404 </td><td> Not Found </td><td>  -  </td></tr>
+   *       <tr><td> 429 </td><td> Too many requests </td><td>  -  </td></tr>
+   *     </table>
+   */
+  public ApiResponse<Void> createUserEmailNotificationChannelWithHttpInfo(String userId, Email body)
+      throws ApiException {
+    Object localVarPostBody = body;
+
+    // verify the required parameter 'userId' is set
+    if (userId == null) {
+      throw new ApiException(
+          400,
+          "Missing the required parameter 'userId' when calling"
+              + " createUserEmailNotificationChannel");
+    }
+
+    // verify the required parameter 'body' is set
+    if (body == null) {
+      throw new ApiException(
+          400,
+          "Missing the required parameter 'body' when calling createUserEmailNotificationChannel");
+    }
+    // create path and map variables
+    String localVarPath =
+        "/api/v2/on-call/users/{user_id}/notification-channels/emails"
+            .replaceAll("\\{" + "user_id" + "\\}", apiClient.escapeString(userId.toString()));
+
+    Map<String, String> localVarHeaderParams = new HashMap<String, String>();
+
+    Invocation.Builder builder =
+        apiClient.createBuilder(
+            "v2.OnCallApi.createUserEmailNotificationChannel",
+            localVarPath,
+            new ArrayList<Pair>(),
+            localVarHeaderParams,
+            new HashMap<String, String>(),
+            new String[] {"*/*"},
+            new String[] {"apiKeyAuth", "appKeyAuth", "AuthZ"});
+    return apiClient.invokeAPI(
+        "POST",
+        builder,
+        localVarHeaderParams,
+        new String[] {"application/json"},
+        localVarPostBody,
+        new HashMap<String, Object>(),
+        false,
+        null);
+  }
+
+  /**
+   * Create email notification channel for user.
+   *
+   * <p>See {@link #createUserEmailNotificationChannelWithHttpInfo}.
+   *
+   * @param userId The user ID (required)
+   * @param body (required)
+   * @return CompletableFuture&lt;ApiResponse&lt;Void&gt;&gt;
+   */
+  public CompletableFuture<ApiResponse<Void>> createUserEmailNotificationChannelWithHttpInfoAsync(
+      String userId, Email body) {
+    Object localVarPostBody = body;
+
+    // verify the required parameter 'userId' is set
+    if (userId == null) {
+      CompletableFuture<ApiResponse<Void>> result = new CompletableFuture<>();
+      result.completeExceptionally(
+          new ApiException(
+              400,
+              "Missing the required parameter 'userId' when calling"
+                  + " createUserEmailNotificationChannel"));
+      return result;
+    }
+
+    // verify the required parameter 'body' is set
+    if (body == null) {
+      CompletableFuture<ApiResponse<Void>> result = new CompletableFuture<>();
+      result.completeExceptionally(
+          new ApiException(
+              400,
+              "Missing the required parameter 'body' when calling"
+                  + " createUserEmailNotificationChannel"));
+      return result;
+    }
+    // create path and map variables
+    String localVarPath =
+        "/api/v2/on-call/users/{user_id}/notification-channels/emails"
+            .replaceAll("\\{" + "user_id" + "\\}", apiClient.escapeString(userId.toString()));
+
+    Map<String, String> localVarHeaderParams = new HashMap<String, String>();
+
+    Invocation.Builder builder;
+    try {
+      builder =
+          apiClient.createBuilder(
+              "v2.OnCallApi.createUserEmailNotificationChannel",
+              localVarPath,
+              new ArrayList<Pair>(),
+              localVarHeaderParams,
+              new HashMap<String, String>(),
+              new String[] {"*/*"},
+              new String[] {"apiKeyAuth", "appKeyAuth", "AuthZ"});
+    } catch (ApiException ex) {
+      CompletableFuture<ApiResponse<Void>> result = new CompletableFuture<>();
+      result.completeExceptionally(ex);
+      return result;
+    }
+    return apiClient.invokeAPIAsync(
+        "POST",
+        builder,
+        localVarHeaderParams,
+        new String[] {"application/json"},
+        localVarPostBody,
+        new HashMap<String, Object>(),
+        false,
+        null);
+  }
+
   /**
    * Delete On-Call escalation policy.
    *