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

# Discover folders of guest-shareable assets

> List asset folders, property scope, sharing activation, ordering and asset counts. Follow nextCursor. Find member assets with list_knowledge_sources assetsOnly=true and match asset.folderId; asset-only uploads have no knowledge chunks. Folder settings affect guest attachment eligibility, not answer text retrieval. Required permission: knowledge:read. Connected business only; no tenant override.



## OpenAPI

````yaml /openapi.json get /knowledge/asset-folders
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:
    get:
      summary: Discover folders of guest-shareable assets
      description: >-
        List asset folders, property scope, sharing activation, ordering and
        asset counts. Follow nextCursor. Find member assets with
        list_knowledge_sources assetsOnly=true and match asset.folderId;
        asset-only uploads have no knowledge chunks. Folder settings affect
        guest attachment eligibility, not answer text retrieval. Required
        permission: knowledge:read. Connected business only; no tenant override.
      operationId: list_knowledge_asset_folders
      parameters:
        - name: limit
          in: query
          required: false
          description: Page size; default 50, maximum 100.
          schema:
            type: integer
            minimum: 1
            maximum: 100
        - name: cursor
          in: query
          required: false
          description: >-
            Copy nextCursor from the previous response and retain all filters.
            Stop when nextCursor is absent; never construct a cursor.
          schema:
            type: string
            maxLength: 400
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KnowledgeAssetFolders'
        '400':
          description: Invalid request
        '403':
          description: Missing permission
        '404':
          description: Resource not found
        '409':
          description: Conflict; read state and reconcile
components:
  schemas:
    KnowledgeAssetFolders:
      type: object
      additionalProperties: false
      properties:
        folders:
          type: array
          items:
            $ref: '#/components/schemas/KnowledgeAssetFolder'
          maxItems: 100
        nextCursor:
          type: string
          maxLength: 128
      required:
        - folders
    KnowledgeAssetFolder:
      type: object
      additionalProperties: false
      properties:
        folderId:
          type: string
          maxLength: 128
        title:
          type: string
          maxLength: 160
        description:
          type: string
          maxLength: 600
        propertyId:
          type: string
          maxLength: 128
        propertyName:
          type: string
          maxLength: 160
        active:
          type: boolean
        shareTokenVersion:
          type: integer
          minimum: 1
        assetOrder:
          type: array
          items:
            type: string
            maxLength: 128
        assetCount:
          type: integer
          minimum: 0
        createdAt:
          type: string
          maxLength: 128
        updatedAt:
          type: string
          maxLength: 128
      required:
        - folderId
        - title
        - active
        - shareTokenVersion
        - assetOrder
        - assetCount
  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.