SDCD-1142: adding custom_tags optional attribute to DORA API spec (#697)

api-clients-generation-pipeline[bot] · ci.datadog-api-spec · web-flow · commit 7b67a59d18fe · 2025-06-16T11:24:04.000Z
Co-authored-by: ci.datadog-api-spec &lt;packages@datadoghq.com&gt;
diff --git a/.apigentools-info b/.apigentools-info
@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-06-13 19:38:13.640241",
-            "spec_repo_commit": "6eb36f2b"
+            "regenerated": "2025-06-16 08:24:49.323712",
+            "spec_repo_commit": "b2c4e7e8"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-06-13 19:38:13.656009",
-            "spec_repo_commit": "6eb36f2b"
+            "regenerated": "2025-06-16 08:24:49.341406",
+            "spec_repo_commit": "b2c4e7e8"
         }
     }
 }
diff --git a/.generator/schemas/v2/openapi.yaml b/.generator/schemas/v2/openapi.yaml
@@ -11095,6 +11095,17 @@ components:
       - version
       - name
       type: object
+    DORACustomTags:
+      description: A list of user-defined tags. The tags must follow the `key:value`
+        pattern. Up to 100 may be added per event.
+      example:
+      - language:java
+      - department:engineering
+      items:
+        description: Tags in the form of `key:value`.
+        type: string
+      nullable: true
+      type: array
     DORADeploymentRequest:
       description: Request to create a DORA deployment event.
       properties:
@@ -11106,6 +11117,8 @@ components:
     DORADeploymentRequestAttributes:
       description: Attributes to create a DORA deployment event.
       properties:
+        custom_tags:
+          $ref: '#/components/schemas/DORACustomTags'
         env:
           description: Environment name to where the service was deployed.
           example: staging
@@ -11208,6 +11221,8 @@ components:
     DORAFailureRequestAttributes:
       description: Attributes to create a DORA failure event.
       properties:
+        custom_tags:
+          $ref: '#/components/schemas/DORACustomTags'
         env:
           description: Environment name that was impacted by the failure.
           example: staging
diff --git a/LICENSE-3rdparty.csv b/LICENSE-3rdparty.csv
@@ -19,6 +19,7 @@ crc32fast,https://github.com/srijs/rust-crc32fast,MIT OR Apache-2.0,"Sam Rijs <s
 darling,https://github.com/TedDriggs/darling,MIT,Ted Driggs <ted.driggs@outlook.com>
 deranged,https://github.com/jhpratt/deranged,MIT OR Apache-2.0,Jacob Pratt <jacob@jhpratt.dev>
 displaydoc,https://github.com/yaahc/displaydoc,MIT OR Apache-2.0,Jane Lusby <jlusby@yaah.dev>
+dyn-clone,https://github.com/dtolnay/dyn-clone,MIT OR Apache-2.0,David Tolnay <dtolnay@gmail.com>
 encoding_rs,https://github.com/hsivonen/encoding_rs,(Apache-2.0 OR MIT) AND BSD-3-Clause,Henri Sivonen <hsivonen@hsivonen.fi>
 equivalent,https://github.com/indexmap-rs/equivalent,Apache-2.0 OR MIT,The equivalent Authors
 errno,https://github.com/lambda-fairy/rust-errno,MIT OR Apache-2.0,"Chris Wong <lambda.fairy@gmail.com>, Dan Gohman <dev@sunfishcode.online>"
@@ -96,6 +97,7 @@ r-efi,https://github.com/r-efi/r-efi,MIT OR Apache-2.0 OR LGPL-2.1-or-later,The
 rand,https://github.com/rust-random/rand,MIT OR Apache-2.0,"The Rand Project Developers, The Rust Project Developers"
 rand_chacha,https://github.com/rust-random/rand,MIT OR Apache-2.0,"The Rand Project Developers, The Rust Project Developers, The CryptoCorrosion Contributors"
 redox_syscall,https://gitlab.redox-os.org/redox-os/syscall,MIT,Jeremy Soller <jackpot51@gmail.com>
+ref-cast,https://github.com/dtolnay/ref-cast,MIT OR Apache-2.0,David Tolnay <dtolnay@gmail.com>
 reqwest,https://github.com/seanmonstar/reqwest,MIT OR Apache-2.0,Sean McArthur <sean@seanmonstar.com>
 reqwest-middleware,https://github.com/TrueLayer/reqwest-middleware,MIT OR Apache-2.0,Rodrigo Gryzinski <rodrigo.gryzinski@truelayer.com>
 retry-policies,https://github.com/TrueLayer/retry-policies,MIT OR Apache-2.0,Luca Palmieri <lpalmieri@truelayer.com>
@@ -105,6 +107,7 @@ rustls-pemfile,https://github.com/rustls/pemfile,Apache-2.0 OR ISC OR MIT,The ru
 rustversion,https://github.com/dtolnay/rustversion,MIT OR Apache-2.0,David Tolnay <dtolnay@gmail.com>
 ryu,https://github.com/dtolnay/ryu,Apache-2.0 OR BSL-1.0,David Tolnay <dtolnay@gmail.com>
 schannel,https://github.com/steffengy/schannel-rs,MIT,"Steven Fackler <sfackler@gmail.com>, Steffen Butzer <steffen.butzer@outlook.com>"
+schemars,https://github.com/GREsau/schemars,MIT,Graham Esau <gesau@hotmail.co.uk>
 scopeguard,https://github.com/bluss/scopeguard,MIT OR Apache-2.0,bluss
 security-framework,https://github.com/kornelski/rust-security-framework,MIT OR Apache-2.0,"Steven Fackler <sfackler@gmail.com>, Kornel <kornel@geekhood.net>"
 serde,https://github.com/serde-rs/serde,MIT OR Apache-2.0,"Erick Tryzelaar <erick.tryzelaar@gmail.com>, David Tolnay <dtolnay@gmail.com>"
diff --git a/examples/v2_dora-metrics_CreateDORAFailure.rs b/examples/v2_dora-metrics_CreateDORAFailure.rs
@@ -11,6 +11,10 @@ use datadog_api_client::datadogV2::model::DORAGitInfo;
 async fn main() {
     let body = DORAFailureRequest::new(DORAFailureRequestData::new(
         DORAFailureRequestAttributes::new(1693491974000000000)
+            .custom_tags(Some(vec![
+                "language:java".to_string(),
+                "department:engineering".to_string(),
+            ]))
             .env("staging".to_string())
             .finished_at(1693491984000000000)
             .git(DORAGitInfo::new(
diff --git a/examples/v2_dora-metrics_CreateDORAIncident.rs b/examples/v2_dora-metrics_CreateDORAIncident.rs
@@ -10,6 +10,10 @@ use datadog_api_client::datadogV2::model::DORAGitInfo;
 async fn main() {
     let body = DORAFailureRequest::new(DORAFailureRequestData::new(
         DORAFailureRequestAttributes::new(1693491974000000000)
+            .custom_tags(Some(vec![
+                "language:java".to_string(),
+                "department:engineering".to_string(),
+            ]))
             .env("staging".to_string())
             .finished_at(1693491984000000000)
             .git(DORAGitInfo::new(
diff --git a/src/datadogV2/model/model_dora_deployment_request_attributes.rs b/src/datadogV2/model/model_dora_deployment_request_attributes.rs
@@ -11,6 +11,13 @@ use std::fmt::{self, Formatter};
 #[skip_serializing_none]
 #[derive(Clone, Debug, PartialEq, Serialize)]
 pub struct DORADeploymentRequestAttributes {
+    /// A list of user-defined tags. The tags must follow the `key:value` pattern. Up to 100 may be added per event.
+    #[serde(
+        rename = "custom_tags",
+        default,
+        with = "::serde_with::rust::double_option"
+    )]
+    pub custom_tags: Option<Option<Vec<String>>>,
     /// Environment name to where the service was deployed.
     #[serde(rename = "env")]
     pub env: Option<String>,
@@ -49,6 +56,7 @@ impl DORADeploymentRequestAttributes {
         started_at: i64,
     ) -> DORADeploymentRequestAttributes {
         DORADeploymentRequestAttributes {
+            custom_tags: None,
             env: None,
             finished_at,
             git: None,
@@ -62,6 +70,11 @@ impl DORADeploymentRequestAttributes {
         }
     }
 
+    pub fn custom_tags(mut self, value: Option<Vec<String>>) -> Self {
+        self.custom_tags = Some(value);
+        self
+    }
+
     pub fn env(mut self, value: String) -> Self {
         self.env = Some(value);
         self
@@ -113,6 +126,7 @@ impl<'de> Deserialize<'de> for DORADeploymentRequestAttributes {
             where
                 M: MapAccess<'a>,
             {
+                let mut custom_tags: Option<Option<Vec<String>>> = None;
                 let mut env: Option<String> = None;
                 let mut finished_at: Option<i64> = None;
                 let mut git: Option<crate::datadogV2::model::DORAGitInfo> = None;
@@ -129,6 +143,10 @@ impl<'de> Deserialize<'de> for DORADeploymentRequestAttributes {
 
                 while let Some((k, v)) = map.next_entry::<String, serde_json::Value>()? {
                     match k.as_str() {
+                        "custom_tags" => {
+                            custom_tags =
+                                Some(serde_json::from_value(v).map_err(M::Error::custom)?);
+                        }
                         "env" => {
                             if v.is_null() {
                                 continue;
@@ -182,6 +200,7 @@ impl<'de> Deserialize<'de> for DORADeploymentRequestAttributes {
                 let started_at = started_at.ok_or_else(|| M::Error::missing_field("started_at"))?;
 
                 let content = DORADeploymentRequestAttributes {
+                    custom_tags,
                     env,
                     finished_at,
                     git,
diff --git a/src/datadogV2/model/model_dora_failure_request_attributes.rs b/src/datadogV2/model/model_dora_failure_request_attributes.rs
@@ -11,6 +11,13 @@ use std::fmt::{self, Formatter};
 #[skip_serializing_none]
 #[derive(Clone, Debug, PartialEq, Serialize)]
 pub struct DORAFailureRequestAttributes {
+    /// A list of user-defined tags. The tags must follow the `key:value` pattern. Up to 100 may be added per event.
+    #[serde(
+        rename = "custom_tags",
+        default,
+        with = "::serde_with::rust::double_option"
+    )]
+    pub custom_tags: Option<Option<Vec<String>>>,
     /// Environment name that was impacted by the failure.
     #[serde(rename = "env")]
     pub env: Option<String>,
@@ -51,6 +58,7 @@ pub struct DORAFailureRequestAttributes {
 impl DORAFailureRequestAttributes {
     pub fn new(started_at: i64) -> DORAFailureRequestAttributes {
         DORAFailureRequestAttributes {
+            custom_tags: None,
             env: None,
             finished_at: None,
             git: None,
@@ -66,6 +74,11 @@ impl DORAFailureRequestAttributes {
         }
     }
 
+    pub fn custom_tags(mut self, value: Option<Vec<String>>) -> Self {
+        self.custom_tags = Some(value);
+        self
+    }
+
     pub fn env(mut self, value: String) -> Self {
         self.env = Some(value);
         self
@@ -137,6 +150,7 @@ impl<'de> Deserialize<'de> for DORAFailureRequestAttributes {
             where
                 M: MapAccess<'a>,
             {
+                let mut custom_tags: Option<Option<Vec<String>>> = None;
                 let mut env: Option<String> = None;
                 let mut finished_at: Option<i64> = None;
                 let mut git: Option<crate::datadogV2::model::DORAGitInfo> = None;
@@ -155,6 +169,10 @@ impl<'de> Deserialize<'de> for DORAFailureRequestAttributes {
 
                 while let Some((k, v)) = map.next_entry::<String, serde_json::Value>()? {
                     match k.as_str() {
+                        "custom_tags" => {
+                            custom_tags =
+                                Some(serde_json::from_value(v).map_err(M::Error::custom)?);
+                        }
                         "env" => {
                             if v.is_null() {
                                 continue;
@@ -223,6 +241,7 @@ impl<'de> Deserialize<'de> for DORAFailureRequestAttributes {
                 let started_at = started_at.ok_or_else(|| M::Error::missing_field("started_at"))?;
 
                 let content = DORAFailureRequestAttributes {
+                    custom_tags,
                     env,
                     finished_at,
                     git,
diff --git a/tests/scenarios/features/v2/dora_metrics.feature b/tests/scenarios/features/v2/dora_metrics.feature
@@ -79,7 +79,7 @@ Feature: DORA Metrics
   @generated @skip @team:DataDog/ci-app-backend
   Scenario: Send a deployment event for DORA Metrics returns "OK - but delayed due to incident" response
     Given new "CreateDORADeployment" request
-    And body with value {"data": {"attributes": {"env": "staging", "finished_at": 1693491984000000000, "git": {"commit_sha": "66adc9350f2cc9b250b69abddab733dd55e1a588", "repository_url": "https://github.com/organization/example-repository"}, "service": "shopist", "started_at": 1693491974000000000, "team": "backend", "version": "v1.12.07"}}}
+    And body with value {"data": {"attributes": {"custom_tags": ["language:java", "department:engineering"], "env": "staging", "finished_at": 1693491984000000000, "git": {"commit_sha": "66adc9350f2cc9b250b69abddab733dd55e1a588", "repository_url": "https://github.com/organization/example-repository"}, "service": "shopist", "started_at": 1693491974000000000, "team": "backend", "version": "v1.12.07"}}}
     When the request is sent
     Then the response status is 202 OK - but delayed due to incident
 
@@ -100,7 +100,7 @@ Feature: DORA Metrics
   @generated @skip @team:DataDog/ci-app-backend
   Scenario: Send a failure event for DORA Metrics returns "OK - but delayed due to incident" response
     Given new "CreateDORAFailure" request
-    And body with value {"data": {"attributes": {"env": "staging", "finished_at": 1693491984000000000, "git": {"commit_sha": "66adc9350f2cc9b250b69abddab733dd55e1a588", "repository_url": "https://github.com/organization/example-repository"}, "name": "Webserver is down failing all requests.", "services": ["shopist"], "severity": "High", "started_at": 1693491974000000000, "team": "backend", "version": "v1.12.07"}}}
+    And body with value {"data": {"attributes": {"custom_tags": ["language:java", "department:engineering"], "env": "staging", "finished_at": 1693491984000000000, "git": {"commit_sha": "66adc9350f2cc9b250b69abddab733dd55e1a588", "repository_url": "https://github.com/organization/example-repository"}, "name": "Webserver is down failing all requests.", "services": ["shopist"], "severity": "High", "started_at": 1693491974000000000, "team": "backend", "version": "v1.12.07"}}}
     When the request is sent
     Then the response status is 202 OK - but delayed due to incident
 
@@ -114,20 +114,20 @@ Feature: DORA Metrics
   @generated @skip @team:DataDog/ci-app-backend
   Scenario: Send an incident event for DORA Metrics returns "Bad Request" response
     Given new "CreateDORAIncident" request
-    And body with value {"data": {"attributes": {"env": "staging", "finished_at": 1693491984000000000, "git": {"commit_sha": "66adc9350f2cc9b250b69abddab733dd55e1a588", "repository_url": "https://github.com/organization/example-repository"}, "name": "Webserver is down failing all requests.", "services": ["shopist"], "severity": "High", "started_at": 1693491974000000000, "team": "backend", "version": "v1.12.07"}}}
+    And body with value {"data": {"attributes": {"custom_tags": ["language:java", "department:engineering"], "env": "staging", "finished_at": 1693491984000000000, "git": {"commit_sha": "66adc9350f2cc9b250b69abddab733dd55e1a588", "repository_url": "https://github.com/organization/example-repository"}, "name": "Webserver is down failing all requests.", "services": ["shopist"], "severity": "High", "started_at": 1693491974000000000, "team": "backend", "version": "v1.12.07"}}}
     When the request is sent
     Then the response status is 400 Bad Request
 
   @generated @skip @team:DataDog/ci-app-backend
   Scenario: Send an incident event for DORA Metrics returns "OK - but delayed due to incident" response
     Given new "CreateDORAIncident" request
-    And body with value {"data": {"attributes": {"env": "staging", "finished_at": 1693491984000000000, "git": {"commit_sha": "66adc9350f2cc9b250b69abddab733dd55e1a588", "repository_url": "https://github.com/organization/example-repository"}, "name": "Webserver is down failing all requests.", "services": ["shopist"], "severity": "High", "started_at": 1693491974000000000, "team": "backend", "version": "v1.12.07"}}}
+    And body with value {"data": {"attributes": {"custom_tags": ["language:java", "department:engineering"], "env": "staging", "finished_at": 1693491984000000000, "git": {"commit_sha": "66adc9350f2cc9b250b69abddab733dd55e1a588", "repository_url": "https://github.com/organization/example-repository"}, "name": "Webserver is down failing all requests.", "services": ["shopist"], "severity": "High", "started_at": 1693491974000000000, "team": "backend", "version": "v1.12.07"}}}
     When the request is sent
     Then the response status is 202 OK - but delayed due to incident
 
   @generated @skip @team:DataDog/ci-app-backend
   Scenario: Send an incident event for DORA Metrics returns "OK" response
     Given new "CreateDORAIncident" request
-    And body with value {"data": {"attributes": {"env": "staging", "finished_at": 1693491984000000000, "git": {"commit_sha": "66adc9350f2cc9b250b69abddab733dd55e1a588", "repository_url": "https://github.com/organization/example-repository"}, "name": "Webserver is down failing all requests.", "services": ["shopist"], "severity": "High", "started_at": 1693491974000000000, "team": "backend", "version": "v1.12.07"}}}
+    And body with value {"data": {"attributes": {"custom_tags": ["language:java", "department:engineering"], "env": "staging", "finished_at": 1693491984000000000, "git": {"commit_sha": "66adc9350f2cc9b250b69abddab733dd55e1a588", "repository_url": "https://github.com/organization/example-repository"}, "name": "Webserver is down failing all requests.", "services": ["shopist"], "severity": "High", "started_at": 1693491974000000000, "team": "backend", "version": "v1.12.07"}}}
     When the request is sent
     Then the response status is 200 OK

Original file line number	Diff line number	Diff line change
`@@ -4,13 +4,13 @@`
`4`	`4`	`"spec_versions": {`
`5`	`5`	`"v1": {`
`6`	`6`	`"apigentools_version": "1.6.6",`
`7`		`- "regenerated": "2025-06-13 19:38:13.640241",`
`8`		`- "spec_repo_commit": "6eb36f2b"`
	`7`	`+ "regenerated": "2025-06-16 08:24:49.323712",`
	`8`	`+ "spec_repo_commit": "b2c4e7e8"`
`9`	`9`	`},`
`10`	`10`	`"v2": {`
`11`	`11`	`"apigentools_version": "1.6.6",`
`12`		`- "regenerated": "2025-06-13 19:38:13.656009",`
`13`		`- "spec_repo_commit": "6eb36f2b"`
	`12`	`+ "regenerated": "2025-06-16 08:24:49.341406",`
	`13`	`+ "spec_repo_commit": "b2c4e7e8"`
`14`	`14`	`}`
`15`	`15`	`}`
`16`	`16`	`}`
-Original file line number
+Diff line change
 darling,https://github.com/TedDriggs/darling,MIT,Ted Driggs <[email protected]>
 deranged,https://github.com/jhpratt/deranged,MIT OR Apache-2.0,Jacob Pratt <[email protected]>
 displaydoc,https://github.com/yaahc/displaydoc,MIT OR Apache-2.0,Jane Lusby <[email protected]>
 +dyn-clone,https://github.com/dtolnay/dyn-clone,MIT OR Apache-2.0,David Tolnay <[email protected]>
 encoding_rs,https://github.com/hsivonen/encoding_rs,(Apache-2.0 OR MIT) AND BSD-3-Clause,Henri Sivonen <[email protected]>
 equivalent,https://github.com/indexmap-rs/equivalent,Apache-2.0 OR MIT,The equivalent Authors
 errno,https://github.com/lambda-fairy/rust-errno,MIT OR Apache-2.0,"Chris Wong <[email protected]>, Dan Gohman <[email protected]>"
 rand,https://github.com/rust-random/rand,MIT OR Apache-2.0,"The Rand Project Developers, The Rust Project Developers"
 rand_chacha,https://github.com/rust-random/rand,MIT OR Apache-2.0,"The Rand Project Developers, The Rust Project Developers, The CryptoCorrosion Contributors"
 redox_syscall,https://gitlab.redox-os.org/redox-os/syscall,MIT,Jeremy Soller <[email protected]>
 +ref-cast,https://github.com/dtolnay/ref-cast,MIT OR Apache-2.0,David Tolnay <[email protected]>
 reqwest,https://github.com/seanmonstar/reqwest,MIT OR Apache-2.0,Sean McArthur <[email protected]>
 reqwest-middleware,https://github.com/TrueLayer/reqwest-middleware,MIT OR Apache-2.0,Rodrigo Gryzinski <[email protected]>
 retry-policies,https://github.com/TrueLayer/retry-policies,MIT OR Apache-2.0,Luca Palmieri <[email protected]>
 rustversion,https://github.com/dtolnay/rustversion,MIT OR Apache-2.0,David Tolnay <[email protected]>
 ryu,https://github.com/dtolnay/ryu,Apache-2.0 OR BSL-1.0,David Tolnay <[email protected]>
 schannel,https://github.com/steffengy/schannel-rs,MIT,"Steven Fackler <[email protected]>, Steffen Butzer <[email protected]>"
 +schemars,https://github.com/GREsau/schemars,MIT,Graham Esau <[email protected]>
 scopeguard,https://github.com/bluss/scopeguard,MIT OR Apache-2.0,bluss
 security-framework,https://github.com/kornelski/rust-security-framework,MIT OR Apache-2.0,"Steven Fackler <[email protected]>, Kornel <[email protected]>"
 serde,https://github.com/serde-rs/serde,MIT OR Apache-2.0,"Erick Tryzelaar <[email protected]>, David Tolnay <[email protected]>"