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

# Set Default Group Access List

> Set or clear the organization's default access list for groups. When set, any group that does not have its own explicit access list will use this one. Pass `null` for `access_list_id` to clear the default. Requires an API key with write manage permissions.

Set or clear the organization's default access list for groups. When set, any group that does not have its own explicit access list will use this one. Pass `null` for `access_list_id` to clear the default.

[Access Lists docs →](/features/access-lists)


## OpenAPI

````yaml POST /v1/manage/org/group/access-list
openapi: 3.0.3
info:
  title: Requesty Management API
  description: >-
    Requesty Management API for API key management, groups, members, and
    organization settings.
  version: 1.0.0
servers:
  - url: https://api-v2.requesty.ai
    description: Management API endpoint
security:
  - BearerAuth: []
paths:
  /v1/manage/org/group/access-list:
    servers:
      - url: https://api-v2.requesty.ai
        description: Management API endpoint
    post:
      summary: Set default group access list
      description: >-
        Set or clear the organization's default access list for groups. When
        set, any group that does not have its own explicit access list will use
        this one. Pass `null` for `access_list_id` to clear the default.
        Requires an API key with write manage permissions.
      operationId: setDefaultGroupAccessList
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SetGroupDefaultAccessListRequest'
      responses:
        '200':
          description: Default group access list updated successfully
        '400':
          description: Bad request - invalid access list ID.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized - missing or invalid Authorization header.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '403':
          description: Forbidden - API key does not have write manage permissions.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not found - the specified access list does not exist.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    SetGroupDefaultAccessListRequest:
      type: object
      properties:
        access_list_id:
          type: string
          format: uuid
          nullable: true
          description: >-
            The access list ID to set as the default for groups. Pass null to
            clear the default.
          example: 123e4567-e89b-12d3-a456-426614174000
    ErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - origin
            - message
          properties:
            origin:
              type: string
              enum:
                - router
                - provider
              description: >-
                Whether the error originated from Requesty's router or an
                upstream provider.
            message:
              type: string
              description: Human-readable error description.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: API key for authentication

````