Update entity version documentation in Software Catalog (#2547)

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": "f2ae7eb",
-  "generated": "2025-07-17 19:53:03.263"
+  "spec_repo_commit": "20279f4",
+  "generated": "2025-07-18 10:22:42.241"
 }

.generator/schemas/v2/openapi.yaml

@@ -13911,14 +13911,21 @@ components:
           type: string
       type: object
     EntityV3APIVersion:
-      description: The schema version of entity type. The field is known as schema-version
-        in the previous version.
+      description: The version of the schema data that was used to populate this entity's
+        data. This could be via the API, Terraform, or YAML file in a repository.
+        The field is known as schema-version in the previous version.
       enum:
       - v3
+      - v2.2
+      - v2.1
+      - v2
       example: v3
       type: string
       x-enum-varnames:
       - V3
+      - V2_2
+      - V2_1
+      - V2
     EntityV3DatadogCodeLocationItem:
       additionalProperties: false
       description: Code location item.

services/software_catalog/src/v2/models/EntityV3API.ts

@@ -12,7 +12,7 @@ import { EntityV3Metadata } from "./EntityV3Metadata";
  */
 export class EntityV3API {
   /**
-   * The schema version of entity type. The field is known as schema-version in the previous version.
+   * The version of the schema data that was used to populate this entity's data. This could be via the API, Terraform, or YAML file in a repository. The field is known as schema-version in the previous version.
    */
   "apiVersion": EntityV3APIVersion;
   /**

services/software_catalog/src/v2/models/EntityV3APIVersion.ts

@@ -1,7 +1,15 @@
 import { UnparsedObject } from "@datadog/datadog-api-client";
 
 /**
- * The schema version of entity type. The field is known as schema-version in the previous version.
+ * The version of the schema data that was used to populate this entity's data. This could be via the API, Terraform, or YAML file in a repository. The field is known as schema-version in the previous version.
  */
-export type EntityV3APIVersion = typeof V3 | UnparsedObject;
+export type EntityV3APIVersion =
+  | typeof V3
+  | typeof V2_2
+  | typeof V2_1
+  | typeof V2
+  | UnparsedObject;
 export const V3 = "v3";
+export const V2_2 = "v2.2";
+export const V2_1 = "v2.1";
+export const V2 = "v2";

services/software_catalog/src/v2/models/EntityV3Datastore.ts

@@ -12,7 +12,7 @@ import { EntityV3Metadata } from "./EntityV3Metadata";
  */
 export class EntityV3Datastore {
   /**
-   * The schema version of entity type. The field is known as schema-version in the previous version.
+   * The version of the schema data that was used to populate this entity's data. This could be via the API, Terraform, or YAML file in a repository. The field is known as schema-version in the previous version.
    */
   "apiVersion": EntityV3APIVersion;
   /**

services/software_catalog/src/v2/models/EntityV3Queue.ts

@@ -12,7 +12,7 @@ import { EntityV3QueueSpec } from "./EntityV3QueueSpec";
  */
 export class EntityV3Queue {
   /**
-   * The schema version of entity type. The field is known as schema-version in the previous version.
+   * The version of the schema data that was used to populate this entity's data. This could be via the API, Terraform, or YAML file in a repository. The field is known as schema-version in the previous version.
    */
   "apiVersion": EntityV3APIVersion;
   /**

services/software_catalog/src/v2/models/EntityV3Service.ts

@@ -12,7 +12,7 @@ import { EntityV3ServiceSpec } from "./EntityV3ServiceSpec";
  */
 export class EntityV3Service {
   /**
-   * The schema version of entity type. The field is known as schema-version in the previous version.
+   * The version of the schema data that was used to populate this entity's data. This could be via the API, Terraform, or YAML file in a repository. The field is known as schema-version in the previous version.
    */
   "apiVersion": EntityV3APIVersion;
   /**

services/software_catalog/src/v2/models/EntityV3System.ts

@@ -12,7 +12,7 @@ import { EntityV3SystemSpec } from "./EntityV3SystemSpec";
  */
 export class EntityV3System {
   /**
-   * The schema version of entity type. The field is known as schema-version in the previous version.
+   * The version of the schema data that was used to populate this entity's data. This could be via the API, Terraform, or YAML file in a repository. The field is known as schema-version in the previous version.
    */
   "apiVersion": EntityV3APIVersion;
   /**

services/software_catalog/src/v2/models/TypingInfo.ts

@@ -81,7 +81,7 @@ export const TypingInfo: ModelTypingInfo = {
     EntityResponseIncludedRelatedEntityType: ["relatedEntity"],
     EntityResponseIncludedSchemaType: ["schema"],
     EntityV3APIKind: ["api"],
-    EntityV3APIVersion: ["v3"],
+    EntityV3APIVersion: ["v3", "v2.2", "v2.1", "v2"],
     EntityV3DatastoreKind: ["datastore"],
     EntityV3QueueKind: ["queue"],
     EntityV3ServiceKind: ["service"],