Add persistent email Synthetics global variables

.generator/schemas/v1/openapi.yaml

@@ -19275,6 +19275,9 @@ components:
           description: Unique identifier of the global variable.
           readOnly: true
           type: string
+        is_email:
+          description: Whether this global variable is a persistent email variable with an email address generated by Datadog.
+          type: boolean
         is_fido:
           description: Determines if the global variable is a FIDO variable.
           type: boolean
@@ -19377,6 +19380,9 @@ components:
           description: Unique identifier of the global variable.
           readOnly: true
           type: string
+        is_email:
+          description: Whether this global variable is a persistent email variable. Set this when creating the variable and omit `value`; Datadog generates an immutable email address. The variable cannot be converted to or from a persistent email variable.
+          type: boolean
         is_fido:
           description: Determines if the global variable is a FIDO variable.
           type: boolean

examples/v1/synthetics/CreateGlobalVariable_2215516655.ts

@@ -0,0 +1,32 @@
+/**
+ * Create a persistent email global variable returns a generated address
+ */
+
+import { client, v1 } from "@datadog/datadog-api-client";
+
+const configuration = client.createConfiguration({
+  authMethods: {
+    AuthZ: {
+      accessToken: process.env.DD_BEARER_TOKEN as string,
+    },
+  },
+});
+const apiInstance = new v1.SyntheticsApi(configuration);
+
+const params: v1.SyntheticsApiCreateGlobalVariableRequest = {
+  body: {
+    name: "PERSISTENT_EMAIL_EXAMPLESYNTHETIC",
+    description: "Persistent email variable",
+    tags: [],
+    isEmail: true,
+  },
+};
+
+apiInstance
+  .createGlobalVariable(params)
+  .then((data: v1.SyntheticsGlobalVariable) => {
+    console.log(
+      "API called successfully. Returned data: " + JSON.stringify(data)
+    );
+  })
+  .catch((error: any) => console.error(error));

features/v1/synthetics.feature

@@ -179,6 +179,16 @@ Feature: Synthetics
     When the request is sent
     Then the response status is 200 OK
 
+  @integration-only @team:DataDog/synthetics-orchestrating-managing
+  Scenario: Create a persistent email global variable returns a generated address
+    Given new "CreateGlobalVariable" request
+    And body with value {"name": "PERSISTENT_EMAIL_{{ unique_upper_alnum }}", "description": "Persistent email variable", "tags": [], "is_email": true}
+    When the request is sent
+    Then the response status is 200 OK
+    And the response "is_email" is equal to true
+    And the response "value.secure" is equal to false
+    And the response "value" has field "value"
+
   @replay-only @team:DataDog/synthetics-orchestrating-managing
   Scenario: Create a private location returns "OK" response
     Given there is a valid "role" in the system

packages/datadog-api-client-v1/models/SyntheticsGlobalVariable.ts

@@ -25,6 +25,10 @@ export class SyntheticsGlobalVariable {
    * Unique identifier of the global variable.
    */
   "id"?: string;
+  /**
+   * Whether this global variable is a persistent email variable with an email address generated by Datadog.
+   */
+  "isEmail"?: boolean;
   /**
    * Determines if the global variable is a FIDO variable.
    */
@@ -83,6 +87,10 @@ export class SyntheticsGlobalVariable {
       baseName: "id",
       type: "string",
     },
+    isEmail: {
+      baseName: "is_email",
+      type: "boolean",
+    },
     isFido: {
       baseName: "is_fido",
       type: "boolean",

packages/datadog-api-client-v1/models/SyntheticsGlobalVariableRequest.ts

@@ -25,6 +25,10 @@ export class SyntheticsGlobalVariableRequest {
    * Unique identifier of the global variable.
    */
   "id"?: string;
+  /**
+   * Whether this global variable is a persistent email variable. Set this when creating the variable and omit `value`; Datadog generates an immutable email address. The variable cannot be converted to or from a persistent email variable.
+   */
+  "isEmail"?: boolean;
   /**
    * Determines if the global variable is a FIDO variable.
    */
@@ -83,6 +87,10 @@ export class SyntheticsGlobalVariableRequest {
       baseName: "id",
       type: "string",
     },
+    isEmail: {
+      baseName: "is_email",
+      type: "boolean",
+    },
     isFido: {
       baseName: "is_fido",
       type: "boolean",