Knowledge Bank API
All the relevant APIs needed to interact with Knowledge Bank for you AI characters with Convai.
API access requires an active Enterprise or Partner subscription.
Upload a new KB File
POST
https://api.convai.com/character/knowledge-bank/upload
Users can upload a new KB file. Once the file is successfully uploaded, they can connect it to a character. Upon calling the API, the file will only be uploaded for processing and will not be available for use until the processing is complete. The upload API will return a unique ID assigned to the uploaded file, which must be used for all future interactions with the file.
Headers
CONVAI-API-KEY*
String
The unique api-key provided for every user. Found under the Key icon when logged into your Convai account.
Request Body
file_name
String
Name of the file
file
Bytes
Raw file bytes
Here are some sample codes to demonstrate the request format for the endpoint -->
Update Existing KB File
POST
https://api.convai.com/character/knowledge-bank/update
Users can update an existing KB file by uploading a new version. Once the file is successfully uploaded, they can connect it to a character. Upon calling the API, the file will only be uploaded for processing and will not be available for use until the processing is complete.
Headers
CONVAI-API-KEY*
String
The unique api-key provided for every user. Found under the Key icon when logged into your Convai account.
Request Body
document_id
String
ID of the existing document that needs to be upated
file
Bytes
Raw file bytes
Here are some sample codes to demonstrate the request format for the endpoint -->
List KB File Status
POST
https://api.convai.com/character/knowledge-bank/list
List the status of KB files. Use this API to check the status of previously uploaded KB files. Once this API returns "is_available" as true for your UUID, you can confidently assume that the previously uploaded file is processed and ready to be connected to your character.
Please note that the list API requires the character_id as input. Accordingly, it returns a "status" field, which can either be "active" or "inactive." This field indicates whether a particular file is connected to a character. A file is considered connected if its "status" is "active" in the output.
Headers
CONVAI-API-KEY*
String
The unique api-key provided for every user. Found under the Key icon when logged into your Convai account.
Request Body
character_id
String
Id of your character.
Here are some sample codes to demonstrate the request format for the endpoint -->
Connect (or Disconnect) a KB file to a Character
POST
https://api.convai.com/character/update
Update API can be used to attach (or remove) a KB file to your character. Once the file is successfully connected, all future interactions with the character will fetch knowledge from the attached KB as needed.
Headers
CONVAI-API-KEY*
String
The unique api-key provided for every user. Found under the Key icon when logged into your Convai account.
Request Body
charID
String
Id of your character.
docs
List
List of JSON. Each entry correspond to a file. Fields "id" and "status".
Here are some sample codes to demonstrate the request format for the endpoint -->
Delete a KB file
POST
https://api.convai.com/character/knowledge-bank/delete
The knowledge bank delete API can be used to permanently remove documents from the user's account. Note that deleting a document will remove it from all characters it is associated with.
Headers
CONVAI-API-KEY*
String
The unique api-key provided for every user. Found under the Key icon when logged into your Convai account.
Request Body
document_id
String
Id of the document that should be deleted.
Here are some sample codes to demonstrate the request format for the endpoint -->
Last updated