To be able to use these maintenance endpoints you need to obtain a token of a service user which belongs to the “root” organization in Zitadel. With a user JWT token of this root organization, which holds the Unique Zitadel project, you are able to call those maintenance endpoints.

Get Token of Root Organisation User

Maintenance Endpoints

Rebuild Specific Collection of Vector DB

Unique AI provides the following endpoint to rebuild a new collection for a specific organization on a tenant. In order to do so you need the following information:

• apiUrl (can be taken from the frontend calls - e.g. gateway.myTenant.unique.app)

• token of the root organisation user

• companyId = Zitadel organisation ID

• (optional query: createNewCollection - default is true. If set to false it will upsert the vectors in the existing collection.)

This will now asynchronously either create a new collection or upsert the existing collection based on the vector data which is existing in the postgres database for this specific company/organisation. You will find information log lines starting with RebuildVectorDatabase in the ingestion service including the line RebuildVectorDatabase: Finished ..., which indicates that the rebuild worked successfully. As soon as the process is finished it will switch to use automatically the new collection for the vector search.

Rebuild full Vector DB

By calling this endpoint Unique AI will rebuild a new collection for every organisation on this tenant. In order to do so you need the following information:

• apiUrl (can be taken from the frontend calls - e.g. gateway.myTenant.unique.app)

• token of the root organisation user

This will now asynchronously create a new collection based on the vector data which is existing in the postgres database. You will find information log lines starting with RebuildVectorDatabase in the ingestion service including the line RebuildVectorDatabase: Finished full sync for x companies, which indicates that the rebuild worked successfully. As soon as one collection is finished it will switch to use automatically this new collection for this company.