Overview

The fetch_knowledge_bases function retrieves a list of AI knowledge bases with optional filtering and pagination support.

Function Signature

pub async fn fetch_knowledge_bases(
    options: Option<ListKnowledgeBasesOptions>
) -> Result<KnowledgeBaseListResponse>

Parameters

options
Option<ListKnowledgeBasesOptions>
Optional configuration for filtering and pagination:
  • page: Page number for pagination (optional)
  • per_page: Number of results per page (optional)
  • search: Search query to filter knowledge bases (optional)

Return Value

Returns Result<KnowledgeBaseListResponse> containing:
  • data: Vector of AiKnowledgeBase objects
  • has_more: Boolean indicating if more results are available

Basic Usage

use wacht::api::knowledge_bases::*;

// Fetch all knowledge bases
let kb_list = fetch_knowledge_bases(None).await?;
for kb in kb_list.data {
    println!("Knowledge Base: {} - {}", kb.name, kb.id);
}

Advanced Usage

use wacht::api::knowledge_bases::*;

// Fetch with pagination and search
let options = ListKnowledgeBasesOptions {
    page: Some(1),
    per_page: Some(10),
    search: Some("documentation".to_string()),
};

let filtered_kb = fetch_knowledge_bases(Some(options)).await?;
println!("Found {} knowledge bases", filtered_kb.data.len());

for kb in filtered_kb.data {
    println!("- {} ({} documents)", kb.name, kb.document_count);
}

Error Handling

match fetch_knowledge_bases(None).await {
    Ok(response) => {
        println!("Successfully retrieved {} knowledge bases", response.data.len());
        for kb in response.data {
            println!("- {} ({})", kb.name, kb.description);
        }
    }
    Err(Error::Api { status, message, .. }) => {
        match status.as_u16() {
            403 => println!("Access denied: {}", message),
            429 => println!("Rate limited: {}", message),
            _ => println!("API error {}: {}", status, message),
        }
    }
    Err(e) => println!("Request failed: {}", e),
}

Rate Limits

  • List operations: 100 requests per minute
  • Burst limit: 10 requests per second