Mark dashboard 'is_read_only' and 'restricted_roles' properties as deprecated (#1476)

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>
Co-authored-by: api-clients-generation-pipeline[bot] <54105614+api-clients-generation-pipeline[bot]@users.noreply.github.com>

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

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-01-12 20:45:32.918266",
-            "spec_repo_commit": "bdf7d582"
+            "regenerated": "2024-01-18 22:52:05.205553",
+            "spec_repo_commit": "4d921fb1"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-01-12 20:45:32.933202",
-            "spec_repo_commit": "bdf7d582"
+            "regenerated": "2024-01-18 22:52:05.224476",
+            "spec_repo_commit": "4d921fb1"
         }
     }
 }

.generator/schemas/v1/openapi.yaml

@@ -1142,9 +1142,12 @@ components:
         is_read_only:
           default: false
           deprecated: true
-          description: Whether this dashboard is read-only. If True, only the author
-            and admins can make changes to it. Prefer using `restricted_roles` to
-            manage write authorization.
+          description: 'Whether this dashboard is read-only. If True, only the author
+            and admins can make changes to it.
+
+
+            This property is deprecated; please use the [Restriction Policies API](https://docs.datadoghq.com/api/latest/restriction-policies/)
+            instead to manage write authorization for individual dashboards.'
           example: false
           type: boolean
         layout_type:
@@ -1165,8 +1168,13 @@ components:
         reflow_type:
           $ref: '#/components/schemas/DashboardReflowType'
         restricted_roles:
-          description: A list of role identifiers. Only the author and users associated
+          deprecated: true
+          description: 'A list of role identifiers. Only the author and users associated
             with at least one of these roles can edit this dashboard.
+
+
+            This property is deprecated; please use the [Restriction Policies API](https://docs.datadoghq.com/api/latest/restriction-policies/)
+            instead to manage write authorization for individual dashboards.'
           items:
             description: A role UUID.
             type: string
@@ -1439,8 +1447,13 @@ components:
           description: Dashboard identifier.
           type: string
         is_read_only:
-          description: Whether this dashboard is read-only. If True, only the author
+          deprecated: true
+          description: 'Whether this dashboard is read-only. If True, only the author
             and admins can make changes to it.
+
+
+            This property is deprecated; please use the [Restriction Policies API](https://docs.datadoghq.com/api/latest/restriction-policies/)
+            instead to manage write authorization for individual dashboards.'
           type: boolean
         layout_type:
           $ref: '#/components/schemas/DashboardLayoutType'

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

@@ -37,7 +37,9 @@ export class Dashboard {
    */
   "id"?: string;
   /**
-   * Whether this dashboard is read-only. If True, only the author and admins can make changes to it. Prefer using `restricted_roles` to manage write authorization.
+   * Whether this dashboard is read-only. If True, only the author and admins can make changes to it.
+   *
+   * This property is deprecated; please use the [Restriction Policies API](https://docs.datadoghq.com/api/latest/restriction-policies/) instead to manage write authorization for individual dashboards.
    */
   "isReadOnly"?: boolean;
   /**
@@ -60,6 +62,8 @@ export class Dashboard {
   "reflowType"?: DashboardReflowType;
   /**
    * A list of role identifiers. Only the author and users associated with at least one of these roles can edit this dashboard.
+   *
+   * This property is deprecated; please use the [Restriction Policies API](https://docs.datadoghq.com/api/latest/restriction-policies/) instead to manage write authorization for individual dashboards.
    */
   "restrictedRoles"?: Array<string>;
   /**

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

@@ -29,6 +29,8 @@ export class DashboardSummaryDefinition {
   "id"?: string;
   /**
    * Whether this dashboard is read-only. If True, only the author and admins can make changes to it.
+   *
+   * This property is deprecated; please use the [Restriction Policies API](https://docs.datadoghq.com/api/latest/restriction-policies/) instead to manage write authorization for individual dashboards.
    */
   "isReadOnly"?: boolean;
   /**