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

# List knowledge sources

> Requires `knowledge:read`. 



## OpenAPI

````yaml /openapi.json get /knowledge/sources
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/sources:
    get:
      tags:
        - Knowledge
      summary: List knowledge sources
      description: 'Requires `knowledge:read`. '
      operationId: m2mGetKnowledgeSources
      parameters:
        - name: limit
          in: query
          schema:
            type: integer
            minimum: 1
            maximum: 200
            default: 50
          description: ''
        - name: cursor
          in: query
          schema:
            type: string
          description: Opaque nextCursor from the preceding page.
        - name: status
          in: query
          schema:
            type: string
          description: ''
        - name: sourceType
          in: query
          schema:
            type: string
          description: ''
        - name: query
          in: query
          schema:
            type: string
          description: ''
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KnowledgeSources'
        default:
          $ref: '#/components/responses/Error'
components:
  schemas:
    KnowledgeSources:
      type: object
      properties:
        sources:
          type: array
          items:
            $ref: '#/components/schemas/KnowledgeSource'
        nextCursor:
          type: string
    KnowledgeSource:
      type: object
      properties:
        sourceId:
          type: string
        sourceType:
          type: string
          enum:
            - text
            - file
            - url
        title:
          type: string
        active:
          type: boolean
        updatedAt:
          type: string
          format: date-time
        text:
          type: string
        url:
          type: string
        chunkCount:
          type: integer
        activeTokens:
          type: integer
        scope:
          type: string
          enum:
            - global
            - property
        propertyId:
          type: string
        propertyName:
          type: string
        preview:
          type: string
        originalFile:
          type: object
          properties:
            filename:
              type: string
            contentType:
              type: string
            size:
              type: integer
            uploadedAt:
              type: string
    ErrorResponse:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              example: M2M_AUTH_INSUFFICIENT_SCOPE
            message:
              type: string
            details:
              type: object
              additionalProperties: true
      example:
        error:
          code: M2M_AUTH_INSUFFICIENT_SCOPE
          message: M2M credential does not have required scope.
          details:
            requiredScopes:
              - conversations:write
            missingScopes:
              - conversations:write
  responses:
    Error:
      description: Structured error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Visito M2M API key
      description: Server-side tenant-scoped credential created from Build > API Keys.

````