Namespaces

ovok.projects

List the projects you administer and manage a project's members, features and settings.

  • Stable unknown
  • Release candidate since 0.4.49-rc.4
  • Development since 0.4.49-dev.517+4645a0a

ovok.projects is for project admins, from a console or a server client. members, features and settings act on the current project, the one the session belongs to.

List your projects

for await (const project of ovok.projects.list()) {
  console.log(project.projectId, project.name);
}
  • list returns a PagePromise: await it for the first page, or for await for every project.
  • It lists the projects the caller administers, wherever they are signed in.

Manage members

const invited = await ovok.projects.members.invite({
  email: 'ada@example.com',
  firstName: 'Ada',
  lastName: 'Lovelace',
  admin: false,
});

await ovok.projects.members.update(invited.id, { admin: true });
await ovok.projects.members.remove(invited.id);
  • list pages through members and filters by accessPolicyId, profileId or userId.
  • update and remove take the membership id.

Turn features on and off

const { features } = await ovok.projects.features.retrieve();

await ovok.projects.features.update(['ai', 'bots', 'email']);
  • update sends the full list of features to enable.

Change settings

Boolean settings and text settings use separate calls.

await ovok.projects.settings.update('PATIENT_REGISTRATION_ENABLED', true);

await ovok.projects.settings.updateText('PATIENT_APP_URL', 'https://app.example.com');
await ovok.projects.settings.updateText('PATIENT_APP_URL', null);
  • Both resolve to all project settings.
  • Passing null clears a text setting.
  • The server rejects an invalid value or a disallowed app URL; see errors and retries.

Reference

Last updated on

On this page