> ## 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.

# Delete Access List

> Delete an access list. The access list cannot be deleted if it is currently assigned to any group or API key. Requires an API key with write manage permissions.

Delete an access list. Returns `409 Conflict` if the access list is currently assigned to any group or API key — unassign it first before deleting.


## OpenAPI

````yaml DELETE /v1/manage/access-list/{access_list_id}
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/access-list/{access_list_id}:
    servers:
      - url: https://api-v2.requesty.ai
        description: Management API endpoint
    delete:
      summary: Delete access list
      description: >-
        Delete an access list. The access list cannot be deleted if it is
        currently assigned to any group or API key. Requires an API key with
        write manage permissions.
      operationId: deleteAccessList
      parameters:
        - name: access_list_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: The access list ID
          example: 123e4567-e89b-12d3-a456-426614174000
      responses:
        '200':
          description: Access list deleted 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 - access list does not exist.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '409':
          description: Conflict - access list is currently in use and cannot be deleted.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '500':
          description: Internal server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    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

````