Knowledge Base API

Knowledge Base API Your knowledge base is what the AI reads from. It has two parts, and this page covers both: Knowledge sources ( /kb-sources ) — the web pages and uploaded documents you feed the platform. Each one is read, split into sections, and turned into FAQs your AI can answer from. Knowledge groups ( /kb-groups ) — named bundles of FAQs you can apply to an Agent or a campaign in a single call, so a body of knowledge you have already curated can be reused on the next Agent you create. The FAQs a source produces land in the same library as the ones you write by hand, so once an import finishes you read, edit and link them with the FAQs API . All endpoints below are relative to the base URL https://api.relaytiv.com/v1 . Every request must be authenticated — see API Access and Authentication . API access is a paid feature; without it, requests are rejected with a 403 . Importing costs credits. Reading a page or document and writing FAQs from it consumes credits, roughly in proportion to how much content there is. Use Estimate an import before committing to a large crawl. How an import works Importing is a background job, not something that finishes while you wait. Every import endpoint answers immediately with a source_id , and you poll that source until it is done: Start the import — POST /kb-sources/url (one page), POST /kb-sources/file (an uploaded document), or POST /kb-sources/bulk-import (up to 100 pages). You get back a source ID and status: "queued" . Poll — GET