Teams API
Team data model
id |
ID of the team |
---|---|
name |
Name of the team |
slug |
URL slug of the team |
description |
Description of the team |
privacy |
Privacy setting of the team (visible , secret ) |
default |
Whether users join this team by default (true , false ) |
created_at |
Time of when the team was created |
created_by |
User who created the team |
List teams
Returns a paginated list of an organization's teams.
curl "https://api.buildkite.com/v2/organizations/{org.slug}/teams"
[
{
"id": "3bf68c45-aba4-416c-9f31-01838da5dc38",
"name": "Everyone",
"slug": "everyone",
"description": "Everyone's welcome",
"created_at": "2019-01-24T01:07:35.855Z",
"privacy": "visible",
"default": false,
"created_by": {
"id": "3d3c3bf0-7d58-4afe-8fe7-b3017d5504de",
"name": "Keith Pitt",
"email": "keith@buildkite.com",
"avatar_url": "https://www.gravatar.com/avatar/e14f55d3f939977cecbf51b64ff6f861",
"created_at": "2015-05-09T21:05:59.874Z"
}
}
]
Optional query string parameters:
user_id |
Filters the results to teams that have the given user as a member. Example: |
---|
Required scope: read_teams
Success response: 200 OK