Add seats API v2 endpoints with error responses and required fields (#3172)

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>

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

.generator/schemas/v2/openapi.yaml

@@ -5385,6 +5385,72 @@ components:
           example: _latest
           type: string
       type: object
+    AssignSeatsUserRequest:
+      properties:
+        data:
+          $ref: '#/components/schemas/AssignSeatsUserRequestData'
+          description: The data for the assign seats user request.
+      type: object
+    AssignSeatsUserRequestData:
+      properties:
+        attributes:
+          $ref: '#/components/schemas/AssignSeatsUserRequestDataAttributes'
+          description: The attributes of the assign seats user request.
+        id:
+          description: The ID of the assign seats user request.
+          type: string
+        type:
+          $ref: '#/components/schemas/SeatAssignmentsDataType'
+          description: The type of the assign seats user request.
+      required:
+      - type
+      - attributes
+      type: object
+    AssignSeatsUserRequestDataAttributes:
+      properties:
+        product_code:
+          description: The product code for which to assign seats.
+          example: ''
+          type: string
+        user_uuids:
+          description: The list of user IDs to assign seats to.
+          example:
+          - ''
+          items:
+            type: string
+          type: array
+      required:
+      - product_code
+      - user_uuids
+      type: object
+    AssignSeatsUserResponse:
+      properties:
+        data:
+          $ref: '#/components/schemas/AssignSeatsUserResponseData'
+          description: The data for the assign seats user response.
+      type: object
+    AssignSeatsUserResponseData:
+      properties:
+        attributes:
+          $ref: '#/components/schemas/AssignSeatsUserResponseDataAttributes'
+          description: The attributes of the assign seats user response.
+        id:
+          description: The ID of the assign seats user response.
+          type: string
+        type:
+          $ref: '#/components/schemas/SeatAssignmentsDataType'
+      type: object
+    AssignSeatsUserResponseDataAttributes:
+      properties:
+        assigned_ids:
+          description: The list of user IDs to which the seats were assigned.
+          items:
+            type: string
+          type: array
+        product_code:
+          description: The product code for which the seats were assigned.
+          type: string
+      type: object
     AttachCaseRequest:
       description: Request for attaching security findings to a case.
       properties:
@@ -52643,6 +52709,80 @@ components:
       - ISSUE_ASSIGNEE
       - ISSUE_CASE
       - ISSUE_TEAM_OWNERS
+    SeatAssignmentsDataType:
+      default: seat-assignments
+      description: Seat assignments resource type.
+      enum:
+      - seat-assignments
+      example: seat-assignments
+      type: string
+      x-enum-varnames:
+      - SEAT_ASSIGNMENTS
+    SeatUserData:
+      properties:
+        attributes:
+          $ref: '#/components/schemas/SeatUserDataAttributes'
+          description: The attributes of the seat user.
+        id:
+          description: The ID of the seat user.
+          example: 00000000-0000-0000-0000-000000000000
+          nullable: true
+          type: string
+        type:
+          $ref: '#/components/schemas/SeatUserDataType'
+      type: object
+    SeatUserDataArray:
+      properties:
+        data:
+          description: The list of seat users.
+          items:
+            $ref: '#/components/schemas/SeatUserData'
+          type: array
+        meta:
+          $ref: '#/components/schemas/SeatUserMeta'
+          description: The metadata of the seat users.
+      type: object
+    SeatUserDataAttributes:
+      properties:
+        assigned_at:
+          description: The date and time the seat was assigned.
+          example: '2021-01-01T00:00:00Z'
+          format: date-time
+          nullable: true
+          type: string
+        email:
+          description: The email of the user.
+          example: user@example.com
+          nullable: true
+          type: string
+        name:
+          description: The name of the user.
+          example: John Doe
+          nullable: true
+          type: string
+      type: object
+    SeatUserDataType:
+      default: seat-users
+      description: Seat users resource type.
+      enum:
+      - seat-users
+      example: seat-users
+      type: string
+      x-enum-varnames:
+      - SEAT_USERS
+    SeatUserMeta:
+      properties:
+        cursor:
+          description: The cursor for the seat users.
+          type: string
+        limit:
+          description: The limit for the seat users.
+          format: int64
+          type: integer
+        next_cursor:
+          description: The next cursor for the seat users.
+          type: string
+      type: object
     SecretRuleArray:
       properties:
         data:
@@ -64824,6 +64964,44 @@ components:
       type: string
       x-enum-varnames:
       - AZURE_UC_CONFIGS
+    UnassignSeatsUserRequest:
+      properties:
+        data:
+          $ref: '#/components/schemas/UnassignSeatsUserRequestData'
+          description: The data for the unassign seats user request.
+      type: object
+    UnassignSeatsUserRequestData:
+      properties:
+        attributes:
+          $ref: '#/components/schemas/UnassignSeatsUserRequestDataAttributes'
+          description: The attributes of the unassign seats user request.
+        id:
+          description: The ID of the unassign seats user request.
+          type: string
+        type:
+          $ref: '#/components/schemas/SeatAssignmentsDataType'
+          description: The type of the unassign seats user request.
+      required:
+      - type
+      - attributes
+      type: object
+    UnassignSeatsUserRequestDataAttributes:
+      properties:
+        product_code:
+          description: The product code for which to unassign seats.
+          example: ''
+          type: string
+        user_uuids:
+          description: The list of user IDs to unassign seats from.
+          example:
+          - ''
+          items:
+            type: string
+          type: array
+      required:
+      - product_code
+      - user_uuids
+      type: object
     Unit:
       description: Object containing the metric unit family, scale factor, name, and
         short name.
@@ -93305,6 +93483,121 @@ paths:
       x-unstable: '**Note**: This endpoint is in public beta.
 
         If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
+  /api/v2/seats/users:
+    delete:
+      description: Unassign seats from users for a product code.
+      operationId: UnassignSeatsUser
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/UnassignSeatsUserRequest'
+        required: true
+      responses:
+        '204':
+          description: No Content
+        '400':
+          $ref: '#/components/responses/BadRequestResponse'
+        '422':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Unprocessable Entity
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: Unassign seats from users
+      tags:
+      - Seats
+      x-permission:
+        operator: OR
+        permissions:
+        - billing_edit
+        - incident_write
+        - on_call_write
+    get:
+      description: Get the list of users assigned seats for a product code.
+      operationId: GetSeatsUsers
+      parameters:
+      - description: The product code for which to retrieve seat users.
+        in: query
+        name: product_code
+        required: true
+        schema:
+          type: string
+      - description: Maximum number of results to return.
+        in: query
+        name: page[limit]
+        required: false
+        schema:
+          type: integer
+      - description: Cursor for pagination.
+        in: query
+        name: page[cursor]
+        required: false
+        schema:
+          type: string
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/SeatUserDataArray'
+          description: OK
+        '400':
+          $ref: '#/components/responses/BadRequestResponse'
+        '422':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Unprocessable Entity
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: Get users with seats
+      tags:
+      - Seats
+      x-permission:
+        operator: OR
+        permissions:
+        - billing_read
+        - incident_read
+        - on_call_read
+    post:
+      description: Assign seats to users for a product code.
+      operationId: AssignSeatsUser
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/AssignSeatsUserRequest'
+        required: true
+      responses:
+        '201':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AssignSeatsUserResponse'
+          description: Created
+        '400':
+          $ref: '#/components/responses/BadRequestResponse'
+        '422':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Unprocessable Entity
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: Assign seats to users
+      tags:
+      - Seats
+      x-permission:
+        operator: OR
+        permissions:
+        - billing_edit
+        - incident_write
+        - on_call_write
   /api/v2/security-entities/risk-scores:
     get:
       description: Get a list of entity risk scores for your organization. Entity
@@ -104454,6 +104747,9 @@ tags:
 - description: Manage retention filters through [Manage Applications](https://app.datadoghq.com/rum/list)
     of RUM for your organization.
   name: Rum Retention Filters
+- description: The seats API allows you to view, assign, and unassign seats for your
+    organization.
+  name: Seats
 - description: Create and manage your security rules, signals, filters, and more.
     See the [Datadog Security page](https://docs.datadoghq.com/security/) for more
     information.

docs/datadog_api_client.v2.api.rst

@@ -550,6 +550,13 @@ datadog\_api\_client.v2.api.rum\_retention\_filters\_api module
    :members:
    :show-inheritance:
 
+datadog\_api\_client.v2.api.seats\_api module
+---------------------------------------------
+
+.. automodule:: datadog_api_client.v2.api.seats_api
+   :members:
+   :show-inheritance:
+
 datadog\_api\_client.v2.api.security\_monitoring\_api module
 ------------------------------------------------------------