Skip to main content
POST

Overview

Manage a knowledge base for personas. Upload real human expertise, documents, and content to train personas with authentic knowledge for enhanced conversations.

Upload Files

Upload documents containing real human expertise to a persona’s knowledge base.

Request

string
required
Persona identifier
file[]
required
Files to upload to knowledge base. Supports:
  • Documents: PDF, DOCX, TXT, MD
  • Images: JPG, PNG, GIF, WEBP
  • Videos: MP4, AVI, MOV, WEBM

Response

array
Successfully uploaded files with metadata
array
Files that failed to upload with error details
number
Count of successfully uploaded files
number
Count of failed uploads

Search Files

Retrieve files from the knowledge base with optional search and filtering.

Query Parameters

string
required
Persona identifier
Search term for file content and names
string
Filter by category: documents, images, or videos
integer
default:"1"
Page number for pagination (min: 1)
integer
default:"20"
Files per page (min: 1, max: 100)

Delete File

Remove a file from the knowledge base.

Path Parameters

string
required
Unique file identifier

Query Parameters

string
required
Persona identifier