> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coderabbit.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Update the seat assignment mode

> Update the seat assignment mode for the organization. Only accessible by fully self-hosted organizations with enterprise plans. Rate limited to 10 requests per 60 seconds per organization.



## OpenAPI

````yaml /openapi.json post /v1/users/seats/assignment
openapi: 3.0.3
info:
  title: CodeRabbit API spec
  version: 1.0.0
servers:
  - url: https://api.coderabbit.ai
security:
  - ApiKeyAuth: []
paths:
  /v1/users/seats/assignment:
    post:
      tags:
        - User Management
      summary: Update the seat assignment mode
      description: >-
        Update the seat assignment mode for the organization. Only accessible by
        fully self-hosted organizations with enterprise plans. Rate limited to
        10 requests per 60 seconds per organization.
      operationId: update-seat-assignment-mode
      parameters:
        - in: header
          name: x-coderabbitai-api-key
          required: true
          schema:
            type: string
          description: API key for authentication
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - mode
              properties:
                mode:
                  type: string
                  enum:
                    - automatic
                    - manual
                  description: >-
                    The seat assignment mode to set. "automatic" auto-assigns
                    seats when CodeRabbit is tagged; "manual" requires admin
                    approval.
                  example: manual
      responses:
        '200':
          description: Seat assignment mode updated successfully
          content:
            application/json:
              schema:
                type: object
                required:
                  - mode
                properties:
                  mode:
                    type: string
                    enum:
                      - automatic
                      - manual
                    description: The updated seat assignment mode
                    example: manual
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        enum:
                          - INVALID_REQUEST
                        example: INVALID_REQUEST
                      message:
                        type: string
                        example: >-
                          Invalid enum value. Expected 'manual' | 'automatic',
                          received 'invalid'
        '401':
          description: Unauthorized - Invalid or missing API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        enum:
                          - UNAUTHORIZED
                        example: UNAUTHORIZED
                      message:
                        type: string
                        example: Invalid or inactive API key
        '402':
          description: Payment Required - No active subscription
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        enum:
                          - NO_ACTIVE_SUBSCRIPTION
                        example: NO_ACTIVE_SUBSCRIPTION
                      message:
                        type: string
                        example: No active subscription found for the organization
        '403':
          description: >-
            Forbidden - Not an admin, not self-hosted, or missing Enterprise
            plan
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        enum:
                          - NOT_ADMIN
                          - SELF_HOSTED_ONLY
                          - ENTERPRISE_PLAN_REQUIRED
                        example: SELF_HOSTED_ONLY
                      message:
                        type: string
                        example: >-
                          This endpoint is only available for self-hosted
                          instances
        '410':
          description: Legacy API key - deprecated and no longer supported
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        enum:
                          - LEGACY_API_KEY
                        example: LEGACY_API_KEY
                      message:
                        type: string
                        example: >-
                          You are using a legacy API key. We are deprecating use
                          of legacy keys. Regenerate a new API key and retry the
                          request.
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        enum:
                          - RATE_LIMIT_EXCEEDED
                      message:
                        type: string
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                        enum:
                          - INTERNAL_ERROR
                        example: INTERNAL_ERROR
                      message:
                        type: string
                        example: >-
                          Internal server error while updating seat assignment
                          mode
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-coderabbitai-api-key
      description: >-
        API key for authentication. You can create an API key from the
        CodeRabbit dashboard.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.