Users & account

Manage users, their roles, and password resets (v2 manager API), and read the current user and the accounts they can access. Available as mgr.users / mgr.me (TypeScript), mgr.Users / mgr.Me (Go), and mgr.users / mgr.me (Rust).

List, create, enable/disable, delete

TypeScript

for await (const user of mgr.users.list()) console.log(user.email);
const all = await mgr.users.listAll({ email: "@acme.com" });

await mgr.users.create({ email: "new.user@acme.com", roles: [] });
await mgr.users.enable(["new.user@acme.com"]);
await mgr.users.disable(["old.user@acme.com"]);
await mgr.users.delete(["old.user@acme.com"]);

Go

for user, err := range mgr.Users.List(ctx, manager.ListUsersQuery{}) {
    if err != nil { log.Fatal(err) }
    fmt.Println(user.Email)
}
_, _ = mgr.Users.Create(ctx, managerapi.CreateManagedUserRequest{Email: "new.user@acme.com"})
_ = mgr.Users.Enable(ctx, []string{"new.user@acme.com"})
_ = mgr.Users.Disable(ctx, []string{"old.user@acme.com"})
_ = mgr.Users.Delete(ctx, []string{"old.user@acme.com"})

Rust

use babelforce_manager_sdk::gen::manager::models::CreateManagedUserRequest;
use babelforce_manager_sdk::ListUsersQuery;

let users = mgr.users.list(ListUsersQuery { email: Some("@acme.com".into()) }).await?;
let all = mgr.users.list_all().await?;

mgr.users.create(CreateManagedUserRequest::new("new.user@acme.com".into(), vec![])).await?;
mgr.users.enable(vec!["new.user@acme.com".into()]).await?;
mgr.users.disable(vec!["old.user@acme.com".into()]).await?;
mgr.users.delete(vec!["old.user@acme.com".into()]).await?;

note

The list-users endpoint exposes no page parameter, so there is nothing to auto-paginate: every SDK issues a single fetch and returns the response as served (the TypeScript async iterator and the Go iter.Seq2 simply yield that one page's items).

Roles

List the assignable role names, and grant or revoke roles for users by email.

TypeScript

const roles = await mgr.users.listRoles();
await mgr.users.addRoles(["agent@acme.com"], ["agent"]);
await mgr.users.removeRoles(["agent@acme.com"], ["supervisor"]);

Go

roles, _ := mgr.Users.ListRoles(ctx)
_ = mgr.Users.AddRoles(ctx, []string{"agent@acme.com"}, []managerapi.AccountRole{"agent"})
_ = mgr.Users.RemoveRoles(ctx, []string{"agent@acme.com"}, []managerapi.AccountRole{"supervisor"})

Rust

use babelforce_manager_sdk::gen::manager::models::AccountRole;

let roles = mgr.users.list_roles().await?;
mgr.users.add_roles(vec!["agent@acme.com".into()], vec![AccountRole::Agent]).await?;
mgr.users.remove_roles(vec!["agent@acme.com".into()], vec![AccountRole::Supervisor]).await?;

Password resets

Trigger a password-reset email for one or more users:

TypeScript

await mgr.users.resetPasswords(["user@acme.com"]);

Go

_ = mgr.Users.ResetPasswords(ctx, []string{"user@acme.com"})

Rust

mgr.users.reset_passwords(vec!["user@acme.com".into()]).await?;

The current user (me)

The me namespace describes the authenticated principal — useful for "who am I" checks, listing the accounts a token can reach, and self-service password reset.

TypeScript

const { item: user } = await mgr.me.get();
const accounts = await mgr.me.accounts();
await mgr.me.resetPassword();

Go

me, _ := mgr.Me.Get(ctx)
accounts, _ := mgr.Me.Accounts(ctx)
_ = mgr.Me.ResetPassword(ctx)

Rust

let me = mgr.me.get().await?;
let accounts = mgr.me.accounts().await?;
mgr.me.reset_password().await?;

Manager-side user lookups

The users resource also exposes the manager-side current principal (me) and a lookup by email.

TypeScript

const me = await mgr.users.me();
const user = await mgr.users.getByEmail("agent@example.com");

Go

me, _ := mgr.Users.Me(ctx)
user, _ := mgr.Users.GetByEmail(ctx, "agent@example.com")

Rust

let me = mgr.users.me().await?;
let user = mgr.users.get_by_email("agent@example.com").await?;

Reference

• Manager API reference — the users resource.
• User API reference — the me namespace.