Method group

enterprise/coderd/groups.go:402–441

@Summary Get group by ID @ID get-group-by-id @Security CoderSessionToken @Produce json @Tags Enterprise @Param group path string true "Group id" @Param exclude_members query bool false "Exclude members from the response" @Success 200 {object} codersdk.Group @Router /api/v2/groups/{group} [get]

(rw http.ResponseWriter, r *http.Request)

// @Success 200 {object} codersdk.Group
// @Router /api/v2/groups/{group} [get]
func (api *API) group(rw http.ResponseWriter, r *http.Request) {
	var (
		ctx   = r.Context()
		group = httpmw.GroupParam(r)
	)

	excludeMembers, _ := strconv.ParseBool(r.URL.Query().Get("exclude_members"))

	org, err := api.Database.GetOrganizationByID(ctx, group.OrganizationID)
	if err != nil {
		httpapi.InternalServerError(rw, err)
	}

	users := []database.GroupMember{}
	if !excludeMembers {
		users, err = api.Database.GetGroupMembersByGroupID(ctx, database.GetGroupMembersByGroupIDParams{
			GroupID:       group.ID,
			IncludeSystem: false,
		})
		if err != nil && !errors.Is(err, sql.ErrNoRows) {
			httpapi.InternalServerError(rw, err)
			return
		}
	}

	memberCount, err := api.Database.GetGroupMembersCountByGroupID(ctx, database.GetGroupMembersCountByGroupIDParams{
		GroupID:       group.ID,
		IncludeSystem: false,
	})
	if err != nil {
		httpapi.InternalServerError(rw, err)
		return
	}

	httpapi.Write(ctx, rw, http.StatusOK, db2sdk.Group(database.GetGroupsRow{
		Group:                   group,
		OrganizationName:        org.Name,
		OrganizationDisplayName: org.DisplayName,
	}, users, int(memberCount)))
}

// @Summary Get group members by organization and group name
// @ID get-group-members-by-organization-and-group-name