closes #2843: collections in API