Skip to main content
Upload your research, brand guidelines, and domain expertise. Autoposting indexes everything with vector embeddings and a knowledge graph — so every AI agent and carousel generation stays grounded in your content, not generic training data.

​
Create a Knowledge Base

curl -X POST https://app.autoposting.ai/api-proxy/kb \
  -H "Authorization: Bearer sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Product Research",
    "slug": "product-research",
    "description": "Competitive analysis, customer interviews, and positioning docs."
  }'

​
Add Documents

1

Request a presigned URL

Call POST /kb/:kbId/docs/upload with the filename and MIME type to receive a presigned upload URL.
2

Upload directly to storage

PUT the file to the presigned URL. No data passes through the Autoposting backend — uploads are fast regardless of file size.
3

Confirm and ingest

Call POST /kb/:kbId/docs/complete with the storage key to trigger the ingestion pipeline.

​
Supported Formats

TypeFormatsDescription
File uploadPDF, DOCX, TXTText extracted automatically during ingestion
URL ingestAny public web pageBackend crawls and extracts page text
Raw text—Paste content directly via the API
Large PDFs (100+ pages) can take 30–90 seconds to fully index. The KB status returns to active when all pending ingestion jobs complete.

​
Ingest a URL

curl -X POST https://app.autoposting.ai/api-proxy/kb/:kbId/docs/ingest-url \
  -H "Authorization: Bearer sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://example.com/report", "label": "Q2 Market Research" }'

​
Search the Knowledge Base

Find semantically relevant content across all indexed documents: 
curl "https://app.autoposting.ai/api-proxy/kb/:kbId/search?q=competitive+pricing&limit=10" \
  -H "Authorization: Bearer sk_your_api_key"

​
KB Status

StatusDescription
activeReady for queries
buildingIngestion job running
errorLast ingestion failed — check errorMessage

​
Connect to an Agent

Attach a KB to an agent via the kbId field. Set contentSource: "both" to combine KB grounding with real-time news signals. 
{
  "name": "Weekly Insights Agent",
  "kbId": "kb_id",
  "contentSource": "kb"
}
Designate one KB as isOrgDefault: true — agents without an explicit kbId automatically use the org default KB.

AI Agents

Connect a KB to an agent for grounded content generation.

Carousels

Use KB content as the source for AI carousel copy.

Posts

KB-powered agent ideas become post drafts in the publish pipeline.

API Reference

Full endpoint reference for KB management and document ingestion.