Skip to content

Commit

Permalink
clarify team owner role (#6384)
Browse files Browse the repository at this point in the history 
* Update Teams.md

* Update Teams.md

* Update docs/topics/Teams.md

Co-authored-by: shay <swdewael@gmail.com>

---------

Co-authored-by: shay <swdewael@gmail.com>
  • Loading branch information
@devsnek @shaydewael
devsnek and shaydewael committed Aug 25, 2023
1 parent 85dc30f commit b6db1da
Showing 1 changed file with 4 additions and 2 deletions.
6 changes: 4 additions & 2 deletions docs/topics/Teams.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -40,11 +40,13 @@ Team members can be one of four roles (owner, admin, developer, and read-only),

| Role Name | Value | Description |
|-----------|-----------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Owner | owner | Owners are the most permissiable role, and can take destructive, irreversible actions like deleting team-owned apps or the team itself. Teams are limited to 1 owner. |
| Owner\* | | Owners are the most permissiable role, and can take destructive, irreversible actions like deleting team-owned apps or the team itself. Teams are limited to 1 owner. |
| Admin | admin | Admins have similar access as owners, except they cannot take destructive actions on the team or team-owned apps. |
| Developer | developer | Developers can access information about team-owned apps, like the client secret or public key. They can also take limited actions on team-owned apps, like configuring interaction endpoints or resetting the bot token. Members with the Developer role *cannot* manage the team or its members, or take destructive actions on team-owned apps. |
| Read-only | read_only | Read-only members can access information about a team and any team-owned apps. Some examples include getting the IDs of applications and exporting payout records. |

\* The owner role is not represented in the `role` field on the [team member object](#DOCS_TOPICS_TEAMS/data-models-team-member-object). Instead, the `owner_user_id` field on the [team object](#DOCS_TOPICS_TEAMS/data-models-team-object) should be used to identify which user has the owner role for the team.


## Data Models

Expand Down Expand Up @@ -73,4 +75,4 @@ Team members can be one of four roles (owner, admin, developer, and read-only),
| name | value |
|----------|-------|
| INVITED | 1 |
| ACCEPTED | 2 |
| ACCEPTED | 2 |

0 comments on commit b6db1da

Please sign in to comment.