[Connections API] NITs on Connection API and creating Action Platform folder

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-01-23 22:26:34.234762",
-            "spec_repo_commit": "6a31fa8c"
+            "regenerated": "2025-01-24 18:37:18.680654",
+            "spec_repo_commit": "9120bb44"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-01-23 22:26:42.184854",
-            "spec_repo_commit": "6a31fa8c"
+            "regenerated": "2025-01-24 18:37:26.952522",
+            "spec_repo_commit": "9120bb44"
         }
     }
 }

content/en/api/v2/action-connection/request.CreateActionConnection_2600083647.json

@@ -0,0 +1,16 @@
+{
+  "data": {
+    "type": "action_connection",
+    "attributes": {
+      "name": "Cassette Connection DELETE_ME",
+      "integration": {
+        "type": "AWS",
+        "credentials": {
+          "type": "AWSAssumeRole",
+          "role": "MyRoleUpdated",
+          "account_id": "123456789123"
+        }
+      }
+    }
+  }
+}

content/en/api/v2/action-connection/request.UpdateActionConnection_2280399724.json

@@ -0,0 +1,16 @@
+{
+  "data": {
+    "type": "action_connection",
+    "attributes": {
+      "name": "Cassette Connection",
+      "integration": {
+        "type": "AWS",
+        "credentials": {
+          "type": "AWSAssumeRole",
+          "role": "MyRoleUpdated",
+          "account_id": "123456789123"
+        }
+      }
+    }
+  }
+}

data/api/v2/CodeExamples.json

@@ -42,14 +42,14 @@
   "CreateActionConnection": [
     {
       "group": "action_connection",
-      "suffix": "",
+      "suffix": "_2600083647",
       "description": "Create a new Action Connection returns \"Successfully created Action Connection\" response"
     }
   ],
   "UpdateActionConnection": [
     {
       "group": "action_connection",
-      "suffix": "",
+      "suffix": "_2280399724",
       "description": "Update an existing Action Connection returns \"Successfully updated Action Connection\" response"
     }
   ],

data/api/v2/full_spec.yaml

@@ -219,7 +219,7 @@ components:
       schema:
         type: string
     ConnectionId:
-      description: The ID of the action connection
+      description: The ID of the Action Connection.
       in: path
       name: connection_id
       required: true
@@ -1248,23 +1248,23 @@ components:
       description: The definition of `AWSAssumeRole` object.
       properties:
         account_id:
-          description: AWS account the connection is created for
+          description: AWS account the connection is created for.
           example: '111222333444'
           pattern: ^\d{12}$
           type: string
         external_id:
           description: External ID used to scope which connection can be used to assume
-            the role
+            the role.
           example: 33a1011635c44b38a064cf14e82e1d8f
           readOnly: true
           type: string
         principal_id:
-          description: AWS account that will assume the role
+          description: AWS account that will assume the role.
           example: '123456789012'
           readOnly: true
           type: string
         role:
-          description: Role to assume
+          description: Role to assume.
           example: my-role
           type: string
         type:
@@ -1286,7 +1286,7 @@ components:
       description: The definition of `AWSAssumeRoleUpdate` object.
       properties:
         account_id:
-          description: AWS account the connection is created for
+          description: AWS account the connection is created for.
           example: '111222333444'
           pattern: ^\d{12}$
           type: string
@@ -1696,7 +1696,7 @@ components:
         integration:
           $ref: '#/components/schemas/ActionConnectionIntegration'
         name:
-          description: Name of the connection
+          description: Name of the connection.
           example: My AWS Connection
           type: string
       required:
@@ -1709,7 +1709,7 @@ components:
         integration:
           $ref: '#/components/schemas/ActionConnectionIntegrationUpdate'
         name:
-          description: Name of the connection
+          description: Name of the connection.
           example: My AWS Connection
           type: string
       type: object
@@ -1719,7 +1719,7 @@ components:
         attributes:
           $ref: '#/components/schemas/ActionConnectionAttributes'
         id:
-          description: The connection identifier
+          description: The connection identifier.
           readOnly: true
           type: string
         type:
@@ -7006,15 +7006,15 @@ components:
       x-enum-varnames:
       - COST_BY_ORG
     CreateActionConnectionRequest:
-      description: Request used to create an action connection.
+      description: Request used to create an Action Connection.
       properties:
         data:
           $ref: '#/components/schemas/ActionConnectionData'
       required:
       - data
       type: object
     CreateActionConnectionResponse:
-      description: The response for a created connection
+      description: The response for a created connection.
       properties:
         data:
           $ref: '#/components/schemas/ActionConnectionData'
@@ -11833,7 +11833,7 @@ components:
       x-enum-varnames:
       - GCP_SERVICE_ACCOUNT
     GetActionConnectionResponse:
-      description: The response for found connection
+      description: The response for found connection.
       properties:
         data:
           $ref: '#/components/schemas/ActionConnectionData'
@@ -12123,7 +12123,7 @@ components:
       description: The definition of `HTTPIntegration` object.
       properties:
         base_url:
-          description: Base HTTP url for the integration
+          description: Base HTTP url for the integration.
           example: http://datadoghq.com
           pattern: url
           type: string
@@ -12148,7 +12148,7 @@ components:
       description: The definition of `HTTPIntegrationUpdate` object.
       properties:
         base_url:
-          description: Base HTTP url for the integration
+          description: Base HTTP url for the integration.
           example: http://datadoghq.com
           pattern: url
           type: string
@@ -28977,7 +28977,7 @@ components:
           type: string
       type: object
     UpdateActionConnectionRequest:
-      description: Request used to update an action connection.
+      description: Request used to update an Action Connection.
       properties:
         data:
           $ref: '#/components/schemas/ActionConnectionDataUpdate'
@@ -30358,7 +30358,7 @@ openapi: 3.0.0
 paths:
   /api/v2/actions/connections:
     post:
-      description: Create a new Action Connection
+      description: Create a new Action Connection.
       operationId: CreateActionConnection
       requestBody:
         content:
@@ -30372,7 +30372,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/CreateActionConnectionResponse'
-          description: Successfully created Action Connection
+          description: Successfully created an Action Connection.
         '400':
           content:
             application/json:
@@ -30406,6 +30406,10 @@ paths:
               \       }\n    }\n  }\n}"
           step: there is a valid "action_connection" in the system
       x-menu-order: 2
+      x-permission:
+        operator: OR
+        permissions:
+        - connection_read
       x-undo:
         operationId: DeleteActionConnection
         parameters:
@@ -30414,7 +30418,7 @@ paths:
         type: unsafe
   /api/v2/actions/connections/{connection_id}:
     delete:
-      description: Delete an existing Action Connection
+      description: Delete an existing Action Connection.
       operationId: DeleteActionConnection
       parameters:
       - $ref: '#/components/parameters/ConnectionId'
@@ -30450,7 +30454,7 @@ paths:
       x-undo:
         type: idempotent
     get:
-      description: Get an existing Action Connection
+      description: Get an existing Action Connection.
       operationId: GetActionConnection
       parameters:
       - $ref: '#/components/parameters/ConnectionId'
@@ -30460,7 +30464,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/GetActionConnectionResponse'
-          description: Successfully get Action Connection
+          description: Successfully got an Action Connection.
         '400':
           content:
             application/json:
@@ -30489,6 +30493,10 @@ paths:
       tags:
       - Action Connection
       x-menu-order: 1
+      x-permission:
+        operator: OR
+        permissions:
+        - connection_read
       x-undo:
         type: safe
     patch:
@@ -30501,15 +30509,15 @@ paths:
           application/json:
             schema:
               $ref: '#/components/schemas/UpdateActionConnectionRequest'
-        description: Update an existing Action Connection request body
+        description: Update an existing Action Connection request body.
         required: true
       responses:
         '200':
           content:
             application/json:
               schema:
                 $ref: '#/components/schemas/UpdateActionConnectionResponse'
-          description: Successfully updated Action Connection
+          description: Successfully updated an Action Connection.
         '400':
           content:
             application/json:
@@ -30538,6 +30546,10 @@ paths:
       tags:
       - Action Connection
       x-menu-order: 3
+      x-permission:
+        operator: OR
+        permissions:
+        - connection_write
       x-undo:
         type: idempotent
   /api/v2/agentless_scanning/accounts/aws:
@@ -51212,13 +51224,15 @@ tags:
   externalDocs:
     url: https://docs.datadoghq.com/integrations/amazon_web_services/#log-collection
   name: AWS Logs Integration
-- description: "Action connections extend your installed integrations and allow you
-    to take action in your third-party systems\n(e.g. AWS, GitLab, and Statuspage)
-    with Datadog\u2019s Workflow Automation and App Builder products.\n\nDatadog\u2019s
+- description: "Action Connections extend your installed integrations and allow you
+    to take action in your third-party systems\n(e.g. AWS, GitLab, and OpenAI) with
+    Datadog\u2019s [Workflow Automation](https://docs.datadoghq.com/service_management/workflows/)\nand
+    [App Builder](https://docs.datadoghq.com/service_management/app_builder/) products.\n\nDatadog\u2019s
     Integrations automatically provide authentication for Slack, Microsoft Teams,
-    PagerDuty, Opsgenie,\nJIRA, GitHub, and Statuspage. You do not need additional
+    PagerDuty, Opsgenie,\nJira, GitHub, and Statuspage. You do not need additional
     connections in order to access these tools within\nWorkflow Automation and App
-    Builder.\n\nWe offer granular access control for editing and resolving connections."
+    Builder.\n\nWe offer granular access control for editing and resolving connections.\n\n**Note:**
+    The Action Connection API currently supports AWS and HTTP integrations."
   externalDocs:
     description: Find out more at
     url: https://docs.datadoghq.com/service_management/workflows/connections/