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

# Delete an asset folder and its member assets

> Existing destructive operation removes the folder and member assets and revokes links. Inspect membership first and use only for requested deletion; active=false is available to pause sharing. Report deletedAssets and reconcile after uncertainty. Required permission: knowledge:write. Connected business only; no tenant override.



## OpenAPI

````yaml /openapi.json delete /knowledge/asset-folders/{folderId}
openapi: 3.0.3
info:
  title: Visito M2M API
  version: 1.0.0
  description: >-
    Tenant-scoped server-to-server API for channels, conversations, commerce,
    custom AI tools, and WhatsApp templates. Send operations are asynchronous
    and return queued acknowledgements. Expansion adds conversation controls,
    knowledge, sales opportunities, delivery status, reporting, and signed
    webhooks.
servers:
  - url: https://platform-api.visitoai.com/m2m/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Channels
  - name: Conversations
  - name: Commerce
  - name: Custom tools
  - name: WhatsApp templates
  - name: Properties
  - name: Knowledge
  - name: Sales CRM
  - name: Delivery
  - name: Reporting
  - name: Webhooks
paths:
  /knowledge/asset-folders/{folderId}:
    delete:
      summary: Delete an asset folder and its member assets
      description: >-
        Existing destructive operation removes the folder and member assets and
        revokes links. Inspect membership first and use only for requested
        deletion; active=false is available to pause sharing. Report
        deletedAssets and reconcile after uncertainty. Required permission:
        knowledge:write. Connected business only; no tenant override.
      operationId: delete_knowledge_asset_folder
      parameters:
        - name: folderId
          in: path
          required: true
          description: >-
            Copy folderId from list_knowledge_asset_folders or
            create_knowledge_asset_folder; it belongs to the connected business.
            Do not derive it from a title, URL or external provider ID.
          schema:
            type: string
            maxLength: 128
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KnowledgeAssetFolderDeleted'
        '400':
          description: Invalid request
        '403':
          description: Missing permission
        '404':
          description: Resource not found
        '409':
          description: Conflict; read state and reconcile
components:
  schemas:
    KnowledgeAssetFolderDeleted:
      type: object
      additionalProperties: false
      properties:
        folderId:
          type: string
          maxLength: 128
        deletedAssets:
          type: integer
          minimum: 0
      required:
        - folderId
        - deletedAssets
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Visito M2M API key
      description: Server-side tenant-scoped credential created from Build > API Keys.

````

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