Organization members API

The organization members API endpoint allows users to view all members of a Buildkite organization.

Organization member data model

id UUID of the user
name Name of the user
email Email of the user

List organization members

Returns a list of an organization's members.

curl -H "Authorization: Bearer $TOKEN" \
  -X GET "https://api.buildkite.com/v2/organizations/{org.slug}/members"

[
    {
        "id": "0185c636-fcbf-4a6c-b49d-c4048e7b8aea",
        "name": "Scout Finch",
        "email": "scout@example.com"
    },
    {
        "id": "0185dbbf-8447-4f72-ac7e-4ea3c2ec8381",
        "name": "Huck Finn",
        "email": "huck@example.com"
    }
]

Required scope: read_organizations

Success response: 200 OK

Get an organization member

curl -H "Authorization: Bearer $TOKEN" \
  -X GET "https://api.buildkite.com/v2/organizations/{org.slug}/members/{user.uuid}"

{
  "id": "0185dbbf-8447-4f72-ac7e-4ea3c2ec8381",
  "name": "Victor Frankenstein",
  "email": "vic@example.com"
}

Required scope: read_organizations

Success response: 200 OK