chore(spec): add missing descriptions to OpenAPI schemas and properties [all]

services/apm/src/v2/models/ServiceList.ts

@@ -2,7 +2,13 @@ import { AttributeTypeMap } from "@datadog/datadog-api-client";
 
 import { ServiceListData } from "./ServiceListData";
 
+/**
+ * The response body for the service list endpoint.
+ */
 export class ServiceList {
+  /**
+   * A single data item in the service list response.
+   */
   "data"?: ServiceListData;
   /**
    * A container for additional, undeclared properties.

services/apm/src/v2/models/ServiceListData.ts

@@ -3,8 +3,17 @@ import { AttributeTypeMap } from "@datadog/datadog-api-client";
 import { ServiceListDataAttributes } from "./ServiceListDataAttributes";
 import { ServiceListDataType } from "./ServiceListDataType";
 
+/**
+ * A single data item in the service list response.
+ */
 export class ServiceListData {
+  /**
+   * Attributes of a service list entry, containing metadata and a list of service names.
+   */
   "attributes"?: ServiceListDataAttributes;
+  /**
+   * The unique identifier of the service.
+   */
   "id"?: string;
   /**
    * Services list resource type.

services/apm/src/v2/models/ServiceListDataAttributes.ts

@@ -2,8 +2,17 @@ import { AttributeTypeMap } from "@datadog/datadog-api-client";
 
 import { ServiceListDataAttributesMetadataItems } from "./ServiceListDataAttributesMetadataItems";
 
+/**
+ * Attributes of a service list entry, containing metadata and a list of service names.
+ */
 export class ServiceListDataAttributes {
+  /**
+   * A list of metadata items associated with the service.
+   */
   "metadata"?: Array<ServiceListDataAttributesMetadataItems>;
+  /**
+   * A list of service names.
+   */
   "services"?: Array<string>;
   /**
    * A container for additional, undeclared properties.

services/apm/src/v2/models/ServiceListDataAttributesMetadataItems.ts

@@ -1,7 +1,16 @@
 import { AttributeTypeMap } from "@datadog/datadog-api-client";
 
+/**
+ * An object containing metadata flags for a service, indicating whether it is traced by APM or monitored through Universal Service Monitoring.
+ */
 export class ServiceListDataAttributesMetadataItems {
+  /**
+   * Indicates whether the service is traced by APM.
+   */
   "isTraced"?: boolean;
+  /**
+   * Indicates whether the service uses Universal Service Monitoring.
+   */
   "isUsm"?: boolean;
   /**
    * A container for additional, undeclared properties.

services/case_management/src/v2/CaseManagementApi.ts

@@ -4030,7 +4030,7 @@ export interface CaseManagementApiCreateCaseServiceNowTicketRequest {
 
 export interface CaseManagementApiCreateProjectRequest {
   /**
-   * Project payload
+   * Project payload.
    * @type ProjectCreateRequest
    */
   body: ProjectCreateRequest;
@@ -4077,7 +4077,7 @@ export interface CaseManagementApiDeleteCaseCustomAttributeRequest {
 
 export interface CaseManagementApiDeleteProjectRequest {
   /**
-   * Project UUID
+   * Project UUID.
    * @type string
    */
   projectId: string;
@@ -4106,7 +4106,7 @@ export interface CaseManagementApiGetCaseRequest {
 
 export interface CaseManagementApiGetProjectRequest {
   /**
-   * Project UUID
+   * Project UUID.
    * @type string
    */
   projectId: string;
@@ -4293,12 +4293,12 @@ export interface CaseManagementApiUpdatePriorityRequest {
 
 export interface CaseManagementApiUpdateProjectRequest {
   /**
-   * Project UUID
+   * Project UUID.
    * @type string
    */
   projectId: string;
   /**
-   * Project payload
+   * Project payload.
    * @type ProjectUpdateRequest
    */
   body: ProjectUpdateRequest;

services/case_management/src/v2/models/AnyValueItem.ts

@@ -1,5 +1,8 @@
 import { UnparsedObject } from "@datadog/datadog-api-client";
 
+/**
+ * A single item in an array of arbitrary values, which can be a string, number, object, or boolean.
+ */
 export type AnyValueItem =
   | string
   | number

services/case_management/src/v2/models/AutoCloseInactiveCases.ts

@@ -1,15 +1,15 @@
 import { AttributeTypeMap } from "@datadog/datadog-api-client";
 
 /**
- * Auto-close inactive cases settings
+ * Auto-close inactive cases settings.
  */
 export class AutoCloseInactiveCases {
   /**
-   * Whether auto-close is enabled
+   * Whether auto-close is enabled.
    */
   "enabled"?: boolean;
   /**
-   * Maximum inactive time in seconds before auto-closing
+   * Maximum inactive time in seconds before auto-closing.
    */
   "maxInactiveTimeInSecs"?: number;
   /**

services/case_management/src/v2/models/AutoTransitionAssignedCases.ts

@@ -1,11 +1,11 @@
 import { AttributeTypeMap } from "@datadog/datadog-api-client";
 
 /**
- * Auto-transition assigned cases settings
+ * Auto-transition assigned cases settings.
  */
 export class AutoTransitionAssignedCases {
   /**
-   * Whether to auto-transition cases when self-assigned
+   * Whether to auto-transition cases when self-assigned.
    */
   "autoTransitionAssignedCasesOnSelfAssigned"?: boolean;
   /**

services/case_management/src/v2/models/CaseCreateRelationships.ts

@@ -12,7 +12,7 @@ export class CaseCreateRelationships {
    */
   "assignee"?: NullableUserRelationship;
   /**
-   * Relationship to project
+   * Relationship to project.
    */
   "project": ProjectRelationship;
   /**

services/case_management/src/v2/models/CaseRelationships.ts

@@ -20,7 +20,7 @@ export class CaseRelationships {
    */
   "modifiedBy"?: NullableUserRelationship;
   /**
-   * Relationship to project
+   * Relationship to project.
    */
   "project"?: ProjectRelationship;
   /**

services/case_management/src/v2/models/IntegrationIncident.ts

@@ -4,26 +4,32 @@ import { IntegrationIncidentFieldMappingsItems } from "./IntegrationIncidentFiel
 import { IntegrationIncidentSeverityConfig } from "./IntegrationIncidentSeverityConfig";
 
 /**
- * Incident integration settings
+ * Incident integration settings.
  */
 export class IntegrationIncident {
   /**
-   * Query for auto-escalation
+   * Query for auto-escalation.
    */
   "autoEscalationQuery"?: string;
   /**
-   * Default incident commander
+   * Default incident commander.
    */
   "defaultIncidentCommander"?: string;
   /**
-   * Whether incident integration is enabled
+   * Whether incident integration is enabled.
    */
   "enabled"?: boolean;
+  /**
+   * List of mappings between incident fields and case fields.
+   */
   "fieldMappings"?: Array<IntegrationIncidentFieldMappingsItems>;
   /**
-   * Incident type
+   * Incident type.
    */
   "incidentType"?: string;
+  /**
+   * Severity configuration for mapping incident priorities to case priorities.
+   */
   "severityConfig"?: IntegrationIncidentSeverityConfig;
   /**
    * A container for additional, undeclared properties.

services/case_management/src/v2/models/IntegrationIncidentFieldMappingsItems.ts

@@ -1,7 +1,16 @@
 import { AttributeTypeMap } from "@datadog/datadog-api-client";
 
+/**
+ * Mapping between an incident user-defined field and a case field.
+ */
 export class IntegrationIncidentFieldMappingsItems {
+  /**
+   * The case field to map the incident field value to.
+   */
   "caseField"?: string;
+  /**
+   * The identifier of the incident user-defined field to map from.
+   */
   "incidentUserDefinedFieldId"?: string;
   /**
    * A container for additional, undeclared properties.

services/case_management/src/v2/models/IntegrationIncidentSeverityConfig.ts

@@ -1,6 +1,12 @@
 import { AttributeTypeMap } from "@datadog/datadog-api-client";
 
+/**
+ * Severity configuration for mapping incident priorities to case priorities.
+ */
 export class IntegrationIncidentSeverityConfig {
+  /**
+   * Mapping of incident severity values to case priority values.
+   */
   "priorityMapping"?: { [key: string]: string };
   /**
    * A container for additional, undeclared properties.

services/case_management/src/v2/models/IntegrationJira.ts

@@ -5,15 +5,24 @@ import { IntegrationJiraMetadata } from "./IntegrationJiraMetadata";
 import { IntegrationJiraSync } from "./IntegrationJiraSync";
 
 /**
- * Jira integration settings
+ * Jira integration settings.
  */
 export class IntegrationJira {
+  /**
+   * Auto-creation settings for Jira issues from cases.
+   */
   "autoCreation"?: IntegrationJiraAutoCreation;
   /**
-   * Whether Jira integration is enabled
+   * Whether Jira integration is enabled.
    */
   "enabled"?: boolean;
+  /**
+   * Metadata for connecting a case management project to a Jira project.
+   */
   "metadata"?: IntegrationJiraMetadata;
+  /**
+   * Synchronization configuration for Jira integration.
+   */
   "sync"?: IntegrationJiraSync;
   /**
    * A container for additional, undeclared properties.

services/case_management/src/v2/models/IntegrationJiraAutoCreation.ts

@@ -1,6 +1,12 @@
 import { AttributeTypeMap } from "@datadog/datadog-api-client";
 
+/**
+ * Auto-creation settings for Jira issues from cases.
+ */
 export class IntegrationJiraAutoCreation {
+  /**
+   * Whether automatic Jira issue creation is enabled.
+   */
   "enabled"?: boolean;
   /**
    * A container for additional, undeclared properties.

services/case_management/src/v2/models/IntegrationJiraMetadata.ts

@@ -1,8 +1,20 @@
 import { AttributeTypeMap } from "@datadog/datadog-api-client";
 
+/**
+ * Metadata for connecting a case management project to a Jira project.
+ */
 export class IntegrationJiraMetadata {
+  /**
+   * The Jira account identifier.
+   */
   "accountId"?: string;
+  /**
+   * The Jira issue type identifier to use when creating issues.
+   */
   "issueTypeId"?: string;
+  /**
+   * The Jira project identifier to associate with this case project.
+   */
   "projectId"?: string;
   /**
    * A container for additional, undeclared properties.

services/case_management/src/v2/models/IntegrationJiraSync.ts

@@ -2,8 +2,17 @@ import { AttributeTypeMap } from "@datadog/datadog-api-client";
 
 import { IntegrationJiraSyncProperties } from "./IntegrationJiraSyncProperties";
 
+/**
+ * Synchronization configuration for Jira integration.
+ */
 export class IntegrationJiraSync {
+  /**
+   * Whether Jira field synchronization is enabled.
+   */
   "enabled"?: boolean;
+  /**
+   * Field synchronization properties for Jira integration.
+   */
   "properties"?: IntegrationJiraSyncProperties;
   /**
    * A container for additional, undeclared properties.

services/case_management/src/v2/models/IntegrationJiraSyncDueDate.ts

@@ -1,7 +1,16 @@
 import { AttributeTypeMap } from "@datadog/datadog-api-client";
 
+/**
+ * Due date synchronization configuration for Jira integration.
+ */
 export class IntegrationJiraSyncDueDate {
+  /**
+   * The Jira field identifier used to store the due date.
+   */
   "jiraFieldId"?: string;
+  /**
+   * The type of synchronization to apply for the due date field.
+   */
   "syncType"?: string;
   /**
    * A container for additional, undeclared properties.

services/case_management/src/v2/models/IntegrationJiraSyncProperties.ts

@@ -5,35 +5,44 @@ import { IntegrationJiraSyncPropertiesCustomFieldsAdditionalProperties } from ".
 import { SyncProperty } from "./SyncProperty";
 import { SyncPropertyWithMapping } from "./SyncPropertyWithMapping";
 
+/**
+ * Field synchronization properties for Jira integration.
+ */
 export class IntegrationJiraSyncProperties {
   /**
-   * Sync property configuration
+   * Sync property configuration.
    */
   "assignee"?: SyncProperty;
   /**
-   * Sync property configuration
+   * Sync property configuration.
    */
   "comments"?: SyncProperty;
+  /**
+   * Map of custom field identifiers to their sync configurations.
+   */
   "customFields"?: {
     [
       key: string
     ]: IntegrationJiraSyncPropertiesCustomFieldsAdditionalProperties;
   };
   /**
-   * Sync property configuration
+   * Sync property configuration.
    */
   "description"?: SyncProperty;
+  /**
+   * Due date synchronization configuration for Jira integration.
+   */
   "dueDate"?: IntegrationJiraSyncDueDate;
   /**
-   * Sync property with mapping configuration
+   * Sync property with mapping configuration.
    */
   "priority"?: SyncPropertyWithMapping;
   /**
-   * Sync property with mapping configuration
+   * Sync property with mapping configuration.
    */
   "status"?: SyncPropertyWithMapping;
   /**
-   * Sync property configuration
+   * Sync property configuration.
    */
   "title"?: SyncProperty;
   /**

services/case_management/src/v2/models/IntegrationJiraSyncPropertiesCustomFieldsAdditionalProperties.ts

@@ -2,7 +2,13 @@ import { AttributeTypeMap } from "@datadog/datadog-api-client";
 
 import { AnyValue } from "./AnyValue";
 
+/**
+ * Synchronization configuration for a Jira custom field.
+ */
 export class IntegrationJiraSyncPropertiesCustomFieldsAdditionalProperties {
+  /**
+   * The type of synchronization to apply for this custom field.
+   */
   "syncType"?: string;
   /**
    * Represents any valid JSON value.