Skip to content

ListTeamOwners

GET/api/v1/teams/{team}/owners

List the users, teams, and groups that are owners of a team. For determining the set of users who are an owner of a team (including indirectly, e.g. via a group or team), use the ListTeamEffectiveOwners API.

Admins can also manage and approve teams without being listed as owners.

Example request

curl \
-H "Authorization: Bearer ${OBLIQUE_API_KEY}" \
"https://us.oblique.security/api/v1/teams/{team}/owners"

Set OBLIQUE_API_KEY to your API key.

Path parameters

  • parentstringrequired

    Name of the team to list the owners of. Can also be teams/- to list all team owners.

    Format: teams/{team}

Query parameters

  • pageSizeinteger (int32)

    The maximum number of owners to return. This service may return fewer than this value.

  • pageTokenstring

    A page token, received from a previous ListTeamOwners call.

Response

200ListTeamOwnersResponse
  • teamOwnersTeamOwner[]

    The owners of the team.

    • namestring

      Assigned by Oblique. The name of the membership. Memberships are always child resources of a given team. The {owner} component is an arbitrary identifier, and doesn’t correspond to the actual member.

    • createTimestring (date-time)read-only
    • updateTimestring (date-time)read-only
    • managementManagement

      How this ownership is managed. Inherited from the parent team: owners of Terraform-managed teams are themselves Terraform managed and can only be created, updated, or deleted through the Terraform provider; manage the parent team to change this. Omitted from responses when the parent team is manually managed (the default).

      • managerstring
        Allowed values: TERRAFORM

        How the resource is managed. Set automatically by the server based on the caller: Terraform clients produce TERRAFORM; for all other clients the management field is left unset on the response.

      • repoUristring

        URI of the VCS repository that holds the Terraform configuration for this resource. Populated by the Oblique Terraform provider.

      • repoDirstring

        Optionally, the subdirectory within repo_uri that holds the Terraform configuration for this resource. Populated by the Oblique Terraform provider.

    • ownerstringrequired

      Set once, when the resource is created. The name of the owner. This can be a user, team, or group.

      Format: users/{user}, teams/{team}, groups/{group}

  • nextPageTokenstring

    A token, which can be sent as page_token to retrieve the next page.

Errors

StatusMeaning
400Malformed request
401Missing or invalid API key
403Not allowed for this API key
404Not found
429Too many requests
500Internal server error