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

US

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

Set OBLIQUE_API_KEY to your API key.

Europe

curl \
  -H "Authorization: Bearer ${OBLIQUE_API_KEY}" \
  "https://eu.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 API objects 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 API object 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 API object. Populated by the Oblique Terraform provider.

    • repoDirstring

      Optionally, the subdirectory within repo_uri that holds the Terraform configuration for this API object. 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

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