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

# Replace Group Mappings



## OpenAPI

````yaml /api-reference/openapi.json put /api/admin/directory/providers/{uuid}/group-mappings
openapi: 3.1.0
info:
  title: Blindsight API
  version: 0.1.0
  description: >-
    The full Blindsight REST surface, generated from the running application.
    Replace the server host with your own deployment.


    For the Runtime Security integration surface (scan, proxy, tool calls) see
    the Runtime Security spec, which is hand written and carries worked
    examples.
servers:
  - url: https://api.your-blindsight.com
    description: Your Blindsight deployment
security: []
paths:
  /api/admin/directory/providers/{uuid}/group-mappings:
    put:
      tags:
        - directory-admin
      summary: Replace Group Mappings
      operationId: >-
        replace_group_mappings_api_admin_directory_providers__uuid__group_mappings_put
      parameters:
        - name: uuid
          in: path
          required: true
          schema:
            type: string
            title: Uuid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/GroupMapping'
              title: Body
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    GroupMapping:
      properties:
        external_group_id:
          type: string
          maxLength: 255
          minLength: 1
          title: External Group Id
        group_display_name:
          anyOf:
            - type: string
              maxLength: 255
            - type: 'null'
          title: Group Display Name
        roles:
          items:
            type: string
          type: array
          title: Roles
      type: object
      required:
        - external_group_id
      title: GroupMapping
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````