Workspaces

A workspace (also called a white-label) is the top-level container for your Releases, knowledge bases, API keys, and users. Manage them through divinci.workspaces.

Listing workspaces

const { data, hasMore, total } = await divinci.workspaces.list({ limit: 20 });

Creating a workspace

const workspace = await divinci.workspaces.create({
  name: "My AI Assistant",
});

console.log(workspace._id);

Reading, updating, deleting

const ws = await divinci.workspaces.get(workspace._id);

await divinci.workspaces.update(workspace._id, { name: "Renamed Assistant" });

await divinci.workspaces.delete(workspace._id);

Usage analytics

Read aggregated usage for a window of "day", "week", or "month":

const usage = await divinci.workspaces.getUsage(workspace._id, "month");

console.log(usage.totalApiCalls);
console.log(usage.totalTokens);
console.log(usage.uniqueUsers);
console.log(usage.activeChats);
console.log(usage.storageUsedBytes);

Method reference

Method	Description
list(options?)	Paginated list of workspaces.
get(workspaceId)	Fetch a single workspace.
create(options)	Create a workspace.
update(workspaceId, options)	Update workspace fields.
delete(workspaceId)	Delete a workspace.
getUsage(workspaceId, period?)	Usage stats for "day" | "week" | "month".

Workspace-scoped configuration

Title and description live on a separate config client:

const config = await divinci.config.get(workspace._id);
await divinci.config.updateTitle(workspace._id, "Support Bot");
await divinci.config.updateDescription(workspace._id, "Answers product questions.");