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."
}'
curl -X POST "https://api.magpipe.ai/functions/v1/knowledge-source-manual" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "title=Product Manual" \
-F "file=@manual.pdf"
{
"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"
}
{
"error": "Content must be at least 50 characters"
}
Knowledge Base
Add Knowledge (Manual)
Add content directly without a URL
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."
}'
curl -X POST "https://api.magpipe.ai/functions/v1/knowledge-source-manual" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "title=Product Manual" \
-F "file=@manual.pdf"
{
"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"
}
{
"error": "Content must be at least 50 characters"
}
Add knowledge by uploading content directly, bypassing URL crawling. Useful for internal documentation, transcripts, or content not available on the web.
Request Body
string
required
Title for the knowledge source
string
Text content to add (minimum 50 characters). Required if not uploading a file.
file
File to upload (PDF, TXT, or MD). Maximum 500KB. Required if not providing content.
Response
string
Unique knowledge source identifier
string
The provided title
string
Status:
completed on successinteger
Number of text chunks created
string
Source type:
manual, pdf, or textcurl -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."
}'
curl -X POST "https://api.magpipe.ai/functions/v1/knowledge-source-manual" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "title=Product Manual" \
-F "file=@manual.pdf"
{
"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"
}
{
"error": "Content must be at least 50 characters"
}
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