Add /api/v2/org_configs specs (#2531)

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>

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-06-17 09:21:30.436144",
-            "spec_repo_commit": "743cf92b"
+            "regenerated": "2024-06-18 16:37:22.237275",
+            "spec_repo_commit": "848af7a9"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-06-17 09:21:30.454502",
-            "spec_repo_commit": "743cf92b"
+            "regenerated": "2024-06-18 16:37:22.255405",
+            "spec_repo_commit": "848af7a9"
         }
     }
 }

.generator/schemas/v2/openapi.yaml

@@ -373,6 +373,14 @@ components:
       required: true
       schema:
         type: string
+    OrgConfigName:
+      description: The name of an Org Config.
+      in: path
+      name: org_config_name
+      required: true
+      schema:
+        example: monitor_timezone
+        type: string
     PageNumber:
       description: Specific page number to return.
       in: query
@@ -13822,6 +13830,104 @@ components:
       required:
       - data
       type: object
+    OrgConfigGetResponse:
+      description: A response with a single Org Config.
+      properties:
+        data:
+          $ref: '#/components/schemas/OrgConfigRead'
+      required:
+      - data
+      type: object
+    OrgConfigListResponse:
+      description: A response with multiple Org Configs.
+      properties:
+        data:
+          description: An array of Org Configs.
+          items:
+            $ref: '#/components/schemas/OrgConfigRead'
+          type: array
+      required:
+      - data
+      type: object
+    OrgConfigRead:
+      description: A single Org Config.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/OrgConfigReadAttributes'
+        id:
+          description: A unique identifier for an Org Config.
+          example: abcd1234
+          type: string
+        type:
+          $ref: '#/components/schemas/OrgConfigType'
+      required:
+      - id
+      - type
+      - attributes
+      type: object
+    OrgConfigReadAttributes:
+      description: Readable attributes of an Org Config.
+      properties:
+        description:
+          description: The description of an Org Config.
+          example: Frobulate the turbo encabulator manifold
+          type: string
+        modified_at:
+          description: The timestamp of the last Org Config update (if any).
+          format: date-time
+          nullable: true
+          type: string
+        name:
+          description: The machine-friendly name of an Org Config.
+          example: monitor_timezone
+          type: string
+        value:
+          description: The value of an Org Config.
+        value_type:
+          description: The type of an Org Config value.
+          example: bool
+          type: string
+      required:
+      - name
+      - description
+      - value_type
+      - value
+      type: object
+    OrgConfigType:
+      description: Data type of an Org Config.
+      enum:
+      - org_configs
+      example: org_configs
+      type: string
+      x-enum-varnames:
+      - ORG_CONFIGS
+    OrgConfigWrite:
+      description: An Org Config write operation.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/OrgConfigWriteAttributes'
+        type:
+          $ref: '#/components/schemas/OrgConfigType'
+      required:
+      - type
+      - attributes
+      type: object
+    OrgConfigWriteAttributes:
+      description: Writable attributes of an Org Config.
+      properties:
+        value:
+          description: The value of an Org Config.
+      required:
+      - value
+      type: object
+    OrgConfigWriteRequest:
+      description: A request to update an Org Config.
+      properties:
+        data:
+          $ref: '#/components/schemas/OrgConfigWrite'
+      required:
+      - data
+      type: object
     Organization:
       description: Organization object.
       properties:
@@ -30455,6 +30561,96 @@ paths:
         limitParam: page[limit]
         pageOffsetParam: page[offset]
         resultsPath: data
+  /api/v2/org_configs:
+    get:
+      description: Returns all Org Configs (name, description, and value).
+      operationId: ListOrgConfigs
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/OrgConfigListResponse'
+          description: OK
+        '400':
+          $ref: '#/components/responses/BadRequestResponse'
+        '401':
+          $ref: '#/components/responses/UnauthorizedResponse'
+        '403':
+          $ref: '#/components/responses/ForbiddenResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      summary: List Org Configs
+      tags:
+      - Organizations
+  /api/v2/org_configs/{org_config_name}:
+    get:
+      description: Return the name, description, and value of a specific Org Config.
+      operationId: GetOrgConfig
+      parameters:
+      - $ref: '#/components/parameters/OrgConfigName'
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/OrgConfigGetResponse'
+          description: OK
+        '400':
+          $ref: '#/components/responses/BadRequestResponse'
+        '401':
+          $ref: '#/components/responses/UnauthorizedResponse'
+        '403':
+          $ref: '#/components/responses/ForbiddenResponse'
+        '404':
+          $ref: '#/components/responses/NotFoundResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      summary: Get a specific Org Config value
+      tags:
+      - Organizations
+    patch:
+      description: Update the value of a specific Org Config.
+      operationId: UpdateOrgConfig
+      parameters:
+      - $ref: '#/components/parameters/OrgConfigName'
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/OrgConfigWriteRequest'
+        required: true
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/OrgConfigGetResponse'
+          description: OK
+        '400':
+          $ref: '#/components/responses/BadRequestResponse'
+        '401':
+          $ref: '#/components/responses/UnauthorizedResponse'
+        '403':
+          $ref: '#/components/responses/ForbiddenResponse'
+        '404':
+          $ref: '#/components/responses/NotFoundResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - org_management
+      summary: Update a specific Org Config
+      tags:
+      - Organizations
   /api/v2/permissions:
     get:
       description: Returns a list of all permissions, including name, description,