Add enum Dataset type to Dataset API spec (DataDog#3281)

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>

Author: api-clients-generation-pipeline[bot]

.generated-info

@@ -1,4 +1,4 @@
 {
-  "spec_repo_commit": "c38287b",
-  "generated": "2025-08-15 18:55:16.469"
+  "spec_repo_commit": "7851858",
+  "generated": "2025-08-18 14:49:19.064"
 }

.generator/schemas/v2/openapi.yaml

@@ -13258,9 +13258,7 @@ components:
         attributes:
           $ref: '#/components/schemas/DatasetAttributesRequest'
         type:
-          description: Resource type, always "dataset".
-          example: dataset
-          type: string
+          $ref: '#/components/schemas/DatasetType'
       required:
       - type
       - attributes
@@ -13282,9 +13280,7 @@ components:
           example: 123e4567-e89b-12d3-a456-426614174000
           type: string
         type:
-          description: Resource type, always "dataset".
-          example: dataset
-          type: string
+          $ref: '#/components/schemas/DatasetType'
       type: object
     DatasetResponseMulti:
       description: Response containing a list of datasets.
@@ -13301,6 +13297,15 @@ components:
         data:
           $ref: '#/components/schemas/DatasetResponse'
       type: object
+    DatasetType:
+      default: dataset
+      description: Resource type, always set to `dataset`.
+      enum:
+      - dataset
+      example: dataset
+      type: string
+      x-enum-varnames:
+      - DATASET
     DatasetUpdateRequest:
       description: Edit request for a dataset.
       properties:

api/datadogV2/model_dataset_request.go

@@ -24,8 +24,8 @@ import (
 type DatasetRequest struct {
 	// Dataset metadata and configurations.
 	Attributes DatasetAttributesRequest `json:"attributes"`
-	// Resource type, always "dataset".
-	Type string `json:"type"`
+	// Resource type, always set to `dataset`.
+	Type DatasetType `json:"type"`
 	// 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:"-"`
@@ -35,7 +35,7 @@ type DatasetRequest struct {
 // 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 NewDatasetRequest(attributes DatasetAttributesRequest, typeVar string) *DatasetRequest {
+func NewDatasetRequest(attributes DatasetAttributesRequest, typeVar DatasetType) *DatasetRequest {
 	this := DatasetRequest{}
 	this.Attributes = attributes
 	this.Type = typeVar
@@ -47,6 +47,8 @@ func NewDatasetRequest(attributes DatasetAttributesRequest, typeVar string) *Dat
 // but it doesn't guarantee that properties required by API are set.
 func NewDatasetRequestWithDefaults() *DatasetRequest {
 	this := DatasetRequest{}
+	var typeVar DatasetType = DATASETTYPE_DATASET
+	this.Type = typeVar
 	return &this
 }
 
@@ -74,25 +76,25 @@ func (o *DatasetRequest) SetAttributes(v DatasetAttributesRequest) {
 }
 
 // GetType returns the Type field value.
-func (o *DatasetRequest) GetType() string {
+func (o *DatasetRequest) GetType() DatasetType {
 	if o == nil {
-		var ret string
+		var ret DatasetType
 		return ret
 	}
 	return o.Type
 }
 
 // GetTypeOk returns a tuple with the Type field value
 // and a boolean to check if the value has been set.
-func (o *DatasetRequest) GetTypeOk() (*string, bool) {
+func (o *DatasetRequest) GetTypeOk() (*DatasetType, bool) {
 	if o == nil {
 		return nil, false
 	}
 	return &o.Type, true
 }
 
 // SetType sets field value.
-func (o *DatasetRequest) SetType(v string) {
+func (o *DatasetRequest) SetType(v DatasetType) {
 	o.Type = v
 }
 
@@ -115,7 +117,7 @@ func (o DatasetRequest) MarshalJSON() ([]byte, error) {
 func (o *DatasetRequest) UnmarshalJSON(bytes []byte) (err error) {
 	all := struct {
 		Attributes *DatasetAttributesRequest `json:"attributes"`
-		Type       *string                   `json:"type"`
+		Type       *DatasetType              `json:"type"`
 	}{}
 	if err = datadog.Unmarshal(bytes, &all); err != nil {
 		return datadog.Unmarshal(bytes, &o.UnparsedObject)
@@ -138,7 +140,11 @@ func (o *DatasetRequest) UnmarshalJSON(bytes []byte) (err error) {
 		hasInvalidField = true
 	}
 	o.Attributes = *all.Attributes
-	o.Type = *all.Type
+	if !all.Type.IsValid() {
+		hasInvalidField = true
+	} else {
+		o.Type = *all.Type
+	}
 
 	if len(additionalProperties) > 0 {
 		o.AdditionalProperties = additionalProperties

api/datadogV2/model_dataset_response.go

@@ -24,8 +24,8 @@ type DatasetResponse struct {
 	Attributes *DatasetAttributesResponse `json:"attributes,omitempty"`
 	// Unique identifier for the dataset.
 	Id *string `json:"id,omitempty"`
-	// Resource type, always "dataset".
-	Type *string `json:"type,omitempty"`
+	// Resource type, always set to `dataset`.
+	Type *DatasetType `json:"type,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:"-"`
@@ -37,6 +37,8 @@ type DatasetResponse struct {
 // will change when the set of required properties is changed.
 func NewDatasetResponse() *DatasetResponse {
 	this := DatasetResponse{}
+	var typeVar DatasetType = DATASETTYPE_DATASET
+	this.Type = &typeVar
 	return &this
 }
 
@@ -45,6 +47,8 @@ func NewDatasetResponse() *DatasetResponse {
 // but it doesn't guarantee that properties required by API are set.
 func NewDatasetResponseWithDefaults() *DatasetResponse {
 	this := DatasetResponse{}
+	var typeVar DatasetType = DATASETTYPE_DATASET
+	this.Type = &typeVar
 	return &this
 }
 
@@ -105,17 +109,17 @@ func (o *DatasetResponse) SetId(v string) {
 }
 
 // GetType returns the Type field value if set, zero value otherwise.
-func (o *DatasetResponse) GetType() string {
+func (o *DatasetResponse) GetType() DatasetType {
 	if o == nil || o.Type == nil {
-		var ret string
+		var ret DatasetType
 		return ret
 	}
 	return *o.Type
 }
 
 // GetTypeOk returns a tuple with the Type field value if set, nil otherwise
 // and a boolean to check if the value has been set.
-func (o *DatasetResponse) GetTypeOk() (*string, bool) {
+func (o *DatasetResponse) GetTypeOk() (*DatasetType, bool) {
 	if o == nil || o.Type == nil {
 		return nil, false
 	}
@@ -127,8 +131,8 @@ func (o *DatasetResponse) HasType() bool {
 	return o != nil && o.Type != nil
 }
 
-// SetType gets a reference to the given string and assigns it to the Type field.
-func (o *DatasetResponse) SetType(v string) {
+// SetType gets a reference to the given DatasetType and assigns it to the Type field.
+func (o *DatasetResponse) SetType(v DatasetType) {
 	o.Type = &v
 }
 
@@ -159,7 +163,7 @@ func (o *DatasetResponse) UnmarshalJSON(bytes []byte) (err error) {
 	all := struct {
 		Attributes *DatasetAttributesResponse `json:"attributes,omitempty"`
 		Id         *string                    `json:"id,omitempty"`
-		Type       *string                    `json:"type,omitempty"`
+		Type       *DatasetType               `json:"type,omitempty"`
 	}{}
 	if err = datadog.Unmarshal(bytes, &all); err != nil {
 		return datadog.Unmarshal(bytes, &o.UnparsedObject)
@@ -177,7 +181,11 @@ func (o *DatasetResponse) UnmarshalJSON(bytes []byte) (err error) {
 	}
 	o.Attributes = all.Attributes
 	o.Id = all.Id
-	o.Type = all.Type
+	if all.Type != nil && !all.Type.IsValid() {
+		hasInvalidField = true
+	} else {
+		o.Type = all.Type
+	}
 
 	if len(additionalProperties) > 0 {
 		o.AdditionalProperties = additionalProperties

api/datadogV2/model_dataset_type.go

@@ -0,0 +1,64 @@
+// 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 (
+	"fmt"
+
+	"github.com/DataDog/datadog-api-client-go/v2/api/datadog"
+)
+
+// DatasetType Resource type, always set to `dataset`.
+type DatasetType string
+
+// List of DatasetType.
+const (
+	DATASETTYPE_DATASET DatasetType = "dataset"
+)
+
+var allowedDatasetTypeEnumValues = []DatasetType{
+	DATASETTYPE_DATASET,
+}
+
+// GetAllowedValues reeturns the list of possible values.
+func (v *DatasetType) GetAllowedValues() []DatasetType {
+	return allowedDatasetTypeEnumValues
+}
+
+// UnmarshalJSON deserializes the given payload.
+func (v *DatasetType) UnmarshalJSON(src []byte) error {
+	var value string
+	err := datadog.Unmarshal(src, &value)
+	if err != nil {
+		return err
+	}
+	*v = DatasetType(value)
+	return nil
+}
+
+// NewDatasetTypeFromValue returns a pointer to a valid DatasetType
+// for the value passed as argument, or an error if the value passed is not allowed by the enum.
+func NewDatasetTypeFromValue(v string) (*DatasetType, error) {
+	ev := DatasetType(v)
+	if ev.IsValid() {
+		return &ev, nil
+	}
+	return nil, fmt.Errorf("invalid value '%v' for DatasetType: valid values are %v", v, allowedDatasetTypeEnumValues)
+}
+
+// IsValid return true if the value is valid for the enum, false otherwise.
+func (v DatasetType) IsValid() bool {
+	for _, existing := range allowedDatasetTypeEnumValues {
+		if existing == v {
+			return true
+		}
+	}
+	return false
+}
+
+// Ptr returns reference to DatasetType value.
+func (v DatasetType) Ptr() *DatasetType {
+	return &v
+}

examples/v2/datasets/CreateDataset.go

@@ -29,7 +29,7 @@ func main() {
 					},
 				},
 			},
-			Type: "dataset",
+			Type: datadogV2.DATASETTYPE_DATASET,
 		},
 	}
 	ctx := datadog.NewDefaultContext(context.Background())

examples/v2/datasets/UpdateDataset.go

@@ -32,7 +32,7 @@ func main() {
 					},
 				},
 			},
-			Type: "dataset",
+			Type: datadogV2.DATASETTYPE_DATASET,
 		},
 	}
 	ctx := datadog.NewDefaultContext(context.Background())