Method users

coderd/users.go:316–370

@Summary Get users @ID get-users @Security CoderSessionToken @Produce json @Tags Users @Param q query string false "Search query" @Param after_id query string false "After ID" format(uuid) @Param limit query int false "Page limit" @Param offset query int false "Page offset" @Success 200 {object} cod

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

// @Success 200 {object} codersdk.GetUsersResponse
// @Router /api/v2/users [get]
func (api *API) users(rw http.ResponseWriter, r *http.Request) {
	ctx := r.Context()
	users, userCount, ok := api.GetUsers(rw, r)
	if !ok {
		return
	}

	userIDs := make([]uuid.UUID, 0, len(users))
	for _, user := range users {
		userIDs = append(userIDs, user.ID)
	}
	organizationIDsByMemberIDsRows, err := api.Database.GetOrganizationIDsByMemberIDs(ctx, userIDs)
	if xerrors.Is(err, sql.ErrNoRows) {
		err = nil
	}
	if err != nil {
		httpapi.Write(ctx, rw, http.StatusInternalServerError, codersdk.Response{
			Message: "Internal error fetching user's organizations.",
			Detail:  err.Error(),
		})
		return
	}
	organizationIDsByUserID := map[uuid.UUID][]uuid.UUID{}
	for _, organizationIDsByMemberIDsRow := range organizationIDsByMemberIDsRows {
		organizationIDsByUserID[organizationIDsByMemberIDsRow.UserID] = organizationIDsByMemberIDsRow.OrganizationIDs
	}

	var aiSeatSet map[uuid.UUID]struct{}
	if api.Entitlements.Enabled(codersdk.FeatureAIGovernanceUserLimit) {
		var aiSeatUserIDs []uuid.UUID
		//nolint:gocritic // AI seat state is a system-level read gated by entitlement.
		aiSeatUserIDs, err = api.Database.GetUserAISeatStates(dbauthz.AsSystemRestricted(ctx), userIDs)
		if err != nil {
			if !xerrors.Is(err, sql.ErrNoRows) {
				api.Logger.Warn(
					ctx,
					"failed to fetch AI seat states for users",
					slog.F("user_count", len(userIDs)),
					slog.Error(err),
				)
			}
			aiSeatUserIDs = nil
		}

		aiSeatSet = make(map[uuid.UUID]struct{}, len(aiSeatUserIDs))
		for _, uid := range aiSeatUserIDs {
			aiSeatSet[uid] = struct{}{}
		}
	}

	httpapi.Write(ctx, rw, http.StatusOK, codersdk.GetUsersResponse{
		Users: convertUsers(users, organizationIDsByUserID, aiSeatSet),
		Count: int(userCount),
	})
}

func (api *API) GetUsers(rw http.ResponseWriter, r *http.Request) ([]database.User, int64, bool) {
	ctx := r.Context()