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 listIt also takes the connection options.
oo teams show
One team: its people and pending invitations
oo teams show TEAM| Argument | Required | Default | Choices | Description |
|---|---|---|---|---|
TEAM | yes | the 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| Argument | Required | Default | Choices | Description |
|---|---|---|---|---|
NAME | yes | its 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| Argument | Required | Default | Choices | Description |
|---|---|---|---|---|
TEAM | yes | the team's name or ID | ||
NAME | yes | its 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| Argument | Required | Default | Choices | Description |
|---|---|---|---|---|
TEAM | yes | the team's name or ID | ||
--yes | no | confirm 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| Argument | Required | Default | Choices | Description |
|---|---|---|---|---|
TEAM | yes | the team's name or ID | ||
PERSON_ID | yes | the 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| Argument | Required | Default | Choices | Description |
|---|---|---|---|---|
PERSON_ID | yes | the person's ID (employeeId in oo people list) |
It also takes the connection options.