> ## 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 knowledge crawl jobs

> Find recent crawl job IDs after a lost receipt or to diagnose queued/running/failed processing. Default active returns queued/running jobs; all includes completed/failed. Bounded recent list (no cursor/history completeness); copy jobId to get_knowledge_crawl. A queued job is not usable indexed knowledge. Required permission: knowledge:read. Connected business only; no tenant override.



## OpenAPI

````yaml /openapi.json get /knowledge/url/crawl
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/url/crawl:
    get:
      summary: Discover knowledge crawl jobs
      description: >-
        Find recent crawl job IDs after a lost receipt or to diagnose
        queued/running/failed processing. Default active returns queued/running
        jobs; all includes completed/failed. Bounded recent list (no
        cursor/history completeness); copy jobId to get_knowledge_crawl. A
        queued job is not usable indexed knowledge. Required permission:
        knowledge:read. Connected business only; no tenant override.
      operationId: list_knowledge_crawls
      parameters:
        - name: limit
          in: query
          required: false
          description: >-
            Recent jobs limit, default twenty, maximum one hundred; no
            pagination.
          schema:
            type: integer
            minimum: 1
            maximum: 100
        - name: status
          in: query
          required: false
          description: Default active means queued/running, not source activation.
          schema:
            type: string
            enum:
              - active
              - all
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KnowledgeCrawlJobs'
        '400':
          description: Invalid request
        '403':
          description: Missing permission
        '404':
          description: Resource not found
        '409':
          description: Conflict; read state and reconcile
components:
  schemas:
    KnowledgeCrawlJobs:
      type: object
      additionalProperties: false
      properties:
        jobs:
          type: array
          items:
            $ref: '#/components/schemas/KnowledgeCrawlJob'
          maxItems: 100
      required:
        - jobs
    KnowledgeCrawlJob:
      type: object
      properties:
        jobId:
          type: string
        status:
          type: string
          enum:
            - queued
            - running
            - completed
            - failed
        progress:
          type: object
          properties:
            phase:
              type: string
              enum:
                - queued
                - crawling
                - embedding
                - finalizing
            pagesDiscovered:
              type: integer
            pagesProcessed:
              type: integer
            chunksEmbedded:
              type: integer
        chunks:
          type: integer
        url:
          type: string
        crawlDepth:
          type: integer
        maxPages:
          type: integer
        sourceId:
          type: string
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
        websiteId:
          type: string
          maxLength: 128
        websiteGenerationId:
          type: string
          maxLength: 128
        createdAt:
          type: string
          maxLength: 128
        startedAt:
          type: string
          maxLength: 128
        completedAt:
          type: string
          maxLength: 128
        updatedAt:
          type: string
          maxLength: 128
        snapshotPages:
          type: integer
          minimum: 0
  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.