The Unblocked API is currently in beta and subject to breaking changes
The Unblocked API is a REST API that allows you to add documents to Unblocked and ask questions about your codebase programmatically. This is a quickstart guide for using the Unblocked API.
To create an API token, click on Settings in the sidebar, then API Tokens under the Team Settings section. This token should be provided with each request to the Unblocked API to authenticate the request.
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.
Copy
Ask AI
curl --request POST \ --url https://getunblocked.com/api/v1/collections \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "name": "Apollo", "description": "Documents from the Apollo customer support tool including support responses.", "iconUrl": "https://my.company.com/apollo/logo.svg"}'
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.
Copy
Ask AI
{ "id": "12345678-abcd-123456789-123456789abc", "name": "Apollo", "description": "Documents from the Apollo customer support tool including support responses.", "iconUrl": "https://my.company.com/apollo/logo.svg"}
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 Data Sources section. Scroll to the documentation section and select Create a Custom Source.
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 its URI. The URI will be used to link to the source of a reference in an answer.
The Answers API (currently in Preview) allows you to programmatically ask questions about your codebase and receive answers from Unblocked. The API uses an asynchronous pattern where you submit a question and then poll for the response.Responses are in Markdown format.
The Answers API is only available to customers on the Enterprise plan. Contact sales at
sales@getunblocked.com or through
Intercom to upgrade your plan.
The Answers API is in Preview and is subject to breaking changes, and is
currently limited to 100 questions per day per organization.