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

# Set asset presentation order within a folder

> Supply distinct member sourceIds in intended order (maximum two hundred). Discover members through list_knowledge_sources assetsOnly=true and asset.folderId. This controls the existing folder ordering used for guest assets; it does not change knowledge text. Required permission: knowledge:write. Connected business only; no tenant override.



## OpenAPI

````yaml /openapi.json put /knowledge/asset-folders/{folderId}/order
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}/order:
    put:
      summary: Set asset presentation order within a folder
      description: >-
        Supply distinct member sourceIds in intended order (maximum two
        hundred). Discover members through list_knowledge_sources
        assetsOnly=true and asset.folderId. This controls the existing folder
        ordering used for guest assets; it does not change knowledge text.
        Required permission: knowledge:write. Connected business only; no tenant
        override.
      operationId: set_knowledge_asset_folder_order
      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
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/KnowledgeAssetFolderOrderInput'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KnowledgeAssetFolderOrderResult'
        '400':
          description: Invalid request
        '403':
          description: Missing permission
        '404':
          description: Resource not found
        '409':
          description: Conflict; read state and reconcile
components:
  schemas:
    KnowledgeAssetFolderOrderInput:
      type: object
      additionalProperties: false
      properties:
        sourceIds:
          type: array
          items:
            type: string
            maxLength: 128
          maxItems: 200
          uniqueItems: true
      required:
        - sourceIds
    KnowledgeAssetFolderOrderResult:
      type: object
      additionalProperties: false
      properties:
        folderId:
          type: string
          maxLength: 128
        sourceIds:
          type: array
          items:
            type: string
            maxLength: 128
          maxItems: 200
      required:
        - folderId
        - sourceIds
  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.