Skip to Content
Referenceoo CLI

oo teams

Teams, who is in them and the permissions they give.

Teams are the departments people are in. A team holds API permissions, given and removed with oo permissions add|list|remove --team, and each person in it who is not an administrator holds them while in it: a new person in the team has them from their first sign-in, and someone who leaves loses them. A team's deny wins over a person's own allow. An administrator holds everything by their role, so a team neither adds to nor limits one.

Reading teams takes people.read; creating, renaming and removing one take access.manage. Putting a person in a team or taking them out changes the person, which needs unrestricted credentials (an administrator's own key, or Clem for the administrator who asked). oo people invite --team puts someone in a team from the moment they register.

oo teams list

Every team, with how many people, invitations and permissions

oo teams list

It also takes the connection options.

oo teams show

One team: its people and pending invitations

oo teams show TEAM
ArgumentRequiredDefaultChoicesDescription
TEAMyesthe team's name or ID

It also takes the connection options.

oo teams create

Add a team; it gives nothing until it has permissions

oo teams create NAME
ArgumentRequiredDefaultChoicesDescription
NAMEyesits name, unique here ignoring case

It also takes the connection options.

oo teams rename

Rename a team, keeping its people and permissions

oo teams rename TEAM NAME
ArgumentRequiredDefaultChoicesDescription
TEAMyesthe team's name or ID
NAMEyesits new name

It also takes the connection options.

oo teams remove

Remove a team, and its permissions with it. It is refused while anyone is in it or a pending invitation names it (team_in_use).

oo teams remove [options] TEAM
ArgumentRequiredDefaultChoicesDescription
TEAMyesthe team's name or ID
--yesnoconfirm it now; an agent passes it only once the person confirmed it in chat

It also takes the connection options.

oo teams join

Put a person in a team, out of any other: they hold its permissions, and lose those of the team they leave. It calls PATCH /api/v1/employees/PERSON_ID.

oo teams join TEAM PERSON_ID
ArgumentRequiredDefaultChoicesDescription
TEAMyesthe team's name or ID
PERSON_IDyesthe person's ID (employeeId in oo people list)

It also takes the connection options.

oo teams leave

Take a person out of their team, and its permissions

oo teams leave PERSON_ID
ArgumentRequiredDefaultChoicesDescription
PERSON_IDyesthe person's ID (employeeId in oo people list)

It also takes the connection options.

On this page