Docs upload via API
The ToothFairyAI platform allows for the programmatic upload of documents. This is done via two separate api calls to decouple the document upload from the document processing. This allows for the upload of documents to be done in a batch process, and the categorisation and processing of documents to be done in a separate process.
Retrieve the workspace token and the workspace id under the section API integrations in the Admin section. ToothFairyAI will show both the workspace token and the workspace id. The workspace token is used to authenticate the upload of documents, and the workspace id is used to identify the workspace to which the documents should be uploaded. Do not share the workspace token with anyone as this will allow anyone to upload documents to your workspace.
Get pre-signed url
We allow users to upload documents using a pre-signed URL to safely store files into our platform - see how
Using the pre-signed URL, upload the file to our platform using the programming language of your choice. The url will be valid for 5 minutes, after which it will expire. If the url expires, you will need to request a new url.
The filename parameter must adhere to the following format:
filename should be unique for each document uploaded to the platform otherwise the document will be overwritten.
Once the file has been uploaded, the
requestUploadURL will return a filePath which is the path to the file on our platform.
Use this path to link the file to a new document on our platform - see how
Well done 🎉
You have successfully uploaded a document to our platform.
The document will now be processed and categorised if the status of the document is set to
published upon creation or update see how.
You can check the status of the document by using the
getDocument endpoint - see how