Skip to main content
POST
/
knowledge-source-manual
curl -X POST "https://api.magpipe.ai/functions/v1/knowledge-source-manual" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Company FAQ",
    "content": "Q: What are your business hours?\nA: We are open Monday through Friday, 9 AM to 5 PM.\n\nQ: Where are you located?\nA: Our office is at 123 Main Street, San Francisco, CA."
  }'

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "title": "Company FAQ",
  "sync_status": "completed",
  "chunk_count": 2,
  "crawl_mode": "manual",
  "created_at": "2026-01-15T10:30:00Z"
}
Add knowledge by uploading content directly, bypassing URL crawling. Useful for internal documentation, transcripts, or content not available on the web.

​
Request Body

​
title
string
required
Title for the knowledge source
​
content
string
Text content to add (minimum 50 characters). Required if not uploading a file.
​
file
file
File to upload (PDF, TXT, or MD). Maximum 500KB. Required if not providing content.

​
Response

​
id
string
Unique knowledge source identifier
​
title
string
The provided title
​
sync_status
string
Status: completed on success
​
chunk_count
integer
Number of text chunks created
​
crawl_mode
string
Source type: manual, pdf, or text
curl -X POST "https://api.magpipe.ai/functions/v1/knowledge-source-manual" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Company FAQ",
    "content": "Q: What are your business hours?\nA: We are open Monday through Friday, 9 AM to 5 PM.\n\nQ: Where are you located?\nA: Our office is at 123 Main Street, San Francisco, CA."
  }'

{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "title": "Company FAQ",
  "sync_status": "completed",
  "chunk_count": 2,
  "crawl_mode": "manual",
  "created_at": "2026-01-15T10:30:00Z"
}

​
Notes

  • Manual sources don’t auto-sync (no sync_period)
  • PDF text extraction works best with text-based PDFs (not scanned images)
  • Supported file types: .pdf, .txt, .md
  • Maximum file size: 500KB