Quickstart for the Unblocked API
The Unblocked API is currently in beta and subject to breaking changes
The Unblocked API is a REST API that allows providing documents to Unblocked to use for answering questions. This is a quickstart guide for using the Unblocked API.
Create an API Token
First, create a token in the API Tokens section of the Settings section of the Unblocked web app. This token should be provided with each request to the Unblocked API to authenticate the request.
Create a Collection
Next, create a collection. A collection in Unblocked is a group of related documents from various data sources, such as customer support tools, knowledge bases, and internal wikis.
Multiple collections can be created to manage documents from different sources.
The Unblocked API will respond with the newly created collection along with an ID. This ID uniquely identifies the collection, and will be used for adding documents to Unblocked.
Collections can also be created in the Unblocked web app. Once you’ve signed in, click Data Sources in the sidebar, and then the Add Sources tab. Scroll to the documentation section and select Create a Custom Source.
Add a Document
Finally, add a document to the collection using the collection’s ID. In addition to the collection ID, provide a title, a body (in plain text or Markdown), and a URI for the document.
A document is uniquely identified by it’s URI. The URI will be used to link to the source of a reference in an answer.