Update app builder API (#2632)

* delete app_deployment

* Regenerate client from commit c020103f of spec repo

---------

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

Author: 3 people

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-01-06 16:11:23.078741",
-            "spec_repo_commit": "24e28b93"
+            "regenerated": "2025-01-06 18:09:30.835401",
+            "spec_repo_commit": "c020103f"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-01-06 16:11:23.108532",
-            "spec_repo_commit": "24e28b93"
+            "regenerated": "2025-01-06 18:09:30.850332",
+            "spec_repo_commit": "c020103f"
         }
     }
 }

.generator/schemas/v2/openapi.yaml

@@ -1634,34 +1634,6 @@ components:
       type: string
       x-enum-varnames:
       - apm_retention_filter
-    AppBuilderError:
-      description: The definition of `AppBuilderError` object.
-      properties:
-        errors:
-          description: The `AppBuilderError` `errors`.
-          items:
-            $ref: '#/components/schemas/AppBuilderErrorErrorsItems'
-          type: array
-      type: object
-    AppBuilderErrorErrorsItems:
-      description: The definition of `AppBuilderErrorErrorsItems` object.
-      properties:
-        detail:
-          description: The `items` `detail`.
-          type: string
-        source:
-          $ref: '#/components/schemas/AppBuilderErrorErrorsItemsSource'
-      type: object
-    AppBuilderErrorErrorsItemsSource:
-      description: The definition of `AppBuilderErrorErrorsItemsSource` object.
-      properties:
-        parameter:
-          description: The `source` `parameter`.
-          type: string
-        pointer:
-          description: The `source` `pointer`.
-          type: string
-      type: object
     AppBuilderEvent:
       additionalProperties: {}
       description: The definition of `AppBuilderEvent` object.
@@ -1748,6 +1720,7 @@ components:
           type: string
         user_uuid:
           description: The `AppMeta` `user_uuid`.
+          format: uuid
           type: string
         version:
           description: The `AppMeta` `version`.
@@ -9114,6 +9087,7 @@ components:
           type: string
         user_uuid:
           description: The `meta` `user_uuid`.
+          format: uuid
           type: string
       type: object
     DeploymentIncludedType:
@@ -9139,6 +9113,7 @@ components:
           type: string
         user_uuid:
           description: The `DeploymentMeta` `user_uuid`.
+          format: uuid
           type: string
       type: object
     DeploymentRelationship:
@@ -9181,6 +9156,7 @@ components:
           type: string
         user_uuid:
           description: The `meta` `user_uuid`.
+          format: uuid
           type: string
       type: object
     DeploymentType:
@@ -31053,19 +31029,19 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/AppBuilderError'
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
           description: Bad Request
         '403':
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/AppBuilderError'
-          description: Forbidden, e.g. missing permissions to delete one or more apps
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
+          description: Forbidden
         '404':
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/AppBuilderError'
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
           description: Not Found
         '429':
           $ref: '#/components/responses/TooManyRequestsResponse'
@@ -31082,63 +31058,71 @@ paths:
       description: List all apps, with optional filters and sorting
       operationId: ListApps
       parameters:
-      - description: The number of apps to return per page
+      - description: The number of apps to return per page.
         in: query
         name: limit
         required: false
         schema:
           format: int64
           type: integer
-      - description: The page number to return
+      - description: The page number to return.
         in: query
         name: page
         required: false
         schema:
           format: int64
           type: integer
-      - description: The `AppsFilter` `user_name`.
+      - description: Filter apps by the app creator. Usually the user's email.
         in: query
         name: filter[user_name]
         required: false
         schema:
           type: string
-      - description: The `AppsFilter` `user_uuid`.
+      - description: Filter apps by the app creator's UUID.
         in: query
         name: filter[user_uuid]
         required: false
         schema:
+          format: uuid
           type: string
-      - description: The `AppsFilter` `name`.
+      - description: Filter by app name.
         in: query
         name: filter[name]
         required: false
         schema:
           type: string
-      - description: The `AppsFilter` `query`.
+      - description: Filter apps by the app name or the app creator.
         in: query
         name: filter[query]
         required: false
         schema:
           type: string
-      - description: The `AppsFilter` `deployed`.
+      - description: Filter apps by whether they are published.
         in: query
         name: filter[deployed]
         required: false
         schema:
           type: boolean
-      - description: The `AppsFilter` `tags`.
+      - description: Filter apps by tags.
         in: query
         name: filter[tags]
         required: false
         schema:
           type: string
-      - description: The `AppsFilter` `favorite`.
+      - description: Filter apps by whether you have added them to your favorites.
         in: query
         name: filter[favorite]
         required: false
         schema:
           type: boolean
-      - explode: false
+      - description: Filter apps by whether they are enabled for self-service.
+        in: query
+        name: filter[self_service]
+        required: false
+        schema:
+          type: boolean
+      - description: The fields and direction to sort apps by.
+        explode: false
         in: query
         name: sort
         required: false
@@ -31158,13 +31142,13 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/AppBuilderError'
-          description: Bad Request, e.g. invalid sort parameter
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
+          description: Bad Request
         '403':
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/AppBuilderError'
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
           description: Forbidden
         '429':
           $ref: '#/components/responses/TooManyRequestsResponse'
@@ -31197,15 +31181,14 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/AppBuilderError'
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
           description: Bad Request
         '403':
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/AppBuilderError'
-          description: Forbidden, e.g. missing required permissions to a connection
-            or workflow used in the app
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
+          description: Forbidden
         '429':
           $ref: '#/components/responses/TooManyRequestsResponse'
       summary: Create App
@@ -31240,25 +31223,25 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/AppBuilderError'
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
           description: Bad Request
         '403':
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/AppBuilderError'
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
           description: Forbidden
         '404':
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/AppBuilderError'
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
           description: Not Found
         '410':
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/AppBuilderError'
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
           description: Gone
         '429':
           $ref: '#/components/responses/TooManyRequestsResponse'
@@ -31280,6 +31263,11 @@ paths:
         required: true
         schema:
           type: string
+      - in: query
+        name: version
+        required: false
+        schema:
+          type: string
       responses:
         '200':
           content:
@@ -31291,19 +31279,19 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/AppBuilderError'
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
           description: Bad Request
         '403':
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/AppBuilderError'
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
           description: Forbidden
         '404':
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/AppBuilderError'
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
           description: Not Found
         '429':
           $ref: '#/components/responses/TooManyRequestsResponse'
@@ -31343,15 +31331,14 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/AppBuilderError'
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
           description: Bad Request
         '403':
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/AppBuilderError'
-          description: Forbidden, e.g. missing required permissions to a connection
-            or workflow used in the app
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
+          description: Forbidden
         '429':
           $ref: '#/components/responses/TooManyRequestsResponse'
       summary: Update App
@@ -31386,25 +31373,25 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/AppBuilderError'
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
           description: Bad Request
         '403':
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/AppBuilderError'
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
           description: Forbidden
         '404':
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/AppBuilderError'
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
           description: Not Found
         '429':
           $ref: '#/components/responses/TooManyRequestsResponse'
       summary: Disable App
       tags:
-      - App Deployment
+      - Apps
       x-permission:
         operator: OR
         permissions:
@@ -31431,25 +31418,25 @@ paths:
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/AppBuilderError'
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
           description: Bad Request
         '403':
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/AppBuilderError'
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
           description: Forbidden
         '404':
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/AppBuilderError'
+                $ref: '#/components/schemas/JSONAPIErrorResponse'
           description: Not Found
         '429':
           $ref: '#/components/responses/TooManyRequestsResponse'
       summary: Deploy App
       tags:
-      - App Deployment
+      - Apps
       x-permission:
         operator: OR
         permissions:
@@ -48120,9 +48107,10 @@ tags:
   externalDocs:
     url: https://docs.datadoghq.com/integrations/amazon_web_services/#log-collection
   name: AWS Logs Integration
-- description: Deploy and disable apps in App Builder.
-  name: App Deployment
-- description: Create, read, update, and delete apps in App Builder.
+- description: Datadog App Builder provides a low-code solution to rapidly develop
+    and integrate secure, customized applications into your monitoring stack that
+    are built to accelerate remediation at scale. These API endpoints allow you to
+    create, read, update, delete, and publish apps.
   name: Apps
 - description: Search your Audit Logs events over HTTP.
   name: Audit