Teams API
Nested teams
GET /orgs/{org}/teams
Every team.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
org required | path | string | The org slug. |
Responses
200- OK. Paged_Team
application/json
POST /orgs/{org}/teams
Creates a team (admins, or managers of the parent team).
Parameters
| Name | In | Type | Description |
|---|---|---|---|
org required | path | string | The org slug. |
Request body
application/json, CreateTeam.
| Field | Type | Description |
|---|---|---|
handle required | string | Handle. |
name required | string | Name. |
parent | string | null | The parent team's handle. |
Responses
201- Created. Team
application/json
GET /orgs/{org}/teams/{handle}
A team and its members.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
org required | path | string | The org slug. |
handle required | path | string | The team's handle. |
Responses
200- OK. Team
application/json
PATCH /orgs/{org}/teams/{handle}
Renames or moves a team (its managers; moving needs the new parent too).
Parameters
| Name | In | Type | Description |
|---|---|---|---|
org required | path | string | The org slug. |
handle required | path | string | The team's handle. |
Request body
application/json, UpdateTeam.
| Field | Type | Description |
|---|---|---|
name | string | null | Name. |
parent | string | null | New parent handle; "" makes it top-level. |
Responses
200- OK. Team
application/json
DELETE /orgs/{org}/teams/{handle}
Deletes a team (its grants go with it; child teams become top-level).
Parameters
| Name | In | Type | Description |
|---|---|---|---|
org required | path | string | The org slug. |
handle required | path | string | The team's handle. |
Responses
204- No content
PUT /orgs/{org}/teams/{handle}/members/{member}
Adds a member to a team, or changes whether they manage it.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
org required | path | string | The org slug. |
handle required | path | string | The team's handle. |
member required | path | string | The member's handle. |
Request body
application/json, PutMember.
| Field | Type | Description |
|---|---|---|
is_manager | boolean | Whether the member manages the team. |
Responses
200- OK. Team
application/json
DELETE /orgs/{org}/teams/{handle}/members/{member}
Removes a member from a team.
Parameters
| Name | In | Type | Description |
|---|---|---|---|
org required | path | string | The org slug. |
handle required | path | string | The team's handle. |
member required | path | string | The member's handle. |
Responses
204- No content