Knowledge API

Overview

Use the Postiv AI Public API to programmatically add company knowledge to your organization's knowledge base. This enables integrations with your existing tools and workflows to keep your sales team's context up to date.

Authentication

Include your API key in the x-api-key header. One API key is issued per organization. Generate your key in Settings → API Key.

bash

curl -X POST https://postiv.ai/api/public/knowledge \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Q3 Positioning", "content": "Our Q3 positioning focuses on..."}'

POST /api/public/knowledge

Adds a knowledge document to your organization's knowledge base. The content will be automatically chunked and embedded for semantic search.

Headers

x-api-key	Your organization API key *
Content-Type	application/json

Request Body

title	Short title for the knowledge entry *
content	Full knowledge content to embed *

Response

json

{
  "success": true,
  "assetId": "2f8b3c94-2d2b-4d91-a4b1-6f55e771d5b3",
  "chunkCount": 3
}

Errors

401	Missing or invalid API key
400	Missing title or content in request body
500	Internal server error while processing request