SuperBins Logo

Collections

Collections are a way to organize and group your bins. They help you manage related bins together and provide a logical structure for your API endpoints.

What are Collections?

Collections are organizational containers that help you group related bins together. Think of them as folders for your API endpoints. They're particularly useful when you have multiple bins that serve related purposes or belong to the same project.

Key Features

  • • Many-to-Many Relationship: A bin can belong to multiple collections
  • • Flexible Organization: Group bins by project, team, or functionality
  • • Easy Management: Quickly find and manage related bins
  • • No Performance Impact: Collections are purely organizational

Creating Collections

You can create collections from your dashboard and then assign bins to them:

  1. 1. Navigate to the Collections page in your dashboard
  2. 2. Click "Create Collection"
  3. 3. Give your collection a descriptive name
  4. 4. Add bins to the collection from the bin management interface

Common Use Cases

Project Organization

Group all bins related to a specific project or application together for easy management and testing.

API Versioning

Organize bins by API version (v1, v2, etc.) to maintain clear separation during development.

Team Collaboration

Create collections for different teams or features, making it easier for team members to find relevant bins.

Environment Separation

Separate bins by environment (development, staging, production) for better workflow management.

Managing Bin-Collection Relationships

Since bins can belong to multiple collections, you have flexible options for organization:

Example Scenario

A user authentication bin might belong to multiple collections:

  • • Mobile App v2 collection
  • • Authentication APIs collection
  • • Production Ready collection

Best Practices

  • • Use descriptive names: Make collection names clear and meaningful
  • • Keep it logical: Group bins that are actually related or used together
  • • Don't over-organize: Too many collections can be as confusing as too few
  • • Review regularly: Clean up unused collections and update bin assignments as needed
  • • Document your strategy: Share your collection naming convention with your team

Next Steps

Ready to start organizing your bins? Head to your dashboard and create your first collection:

Manage Collections