Collections
A Face Collection is an isolated group of enrolled faces. API keys are scoped to a single collection, keeping your different applications or tenants completely separated.
⚙️ Dashboard-only operation
Managing collections in the dashboard
- Create: Go to Collections → New Collection. Provide a name and optional description.
- List / view: The Collections page shows all collections with face count and creation date.
- Update: Open a collection and click Edit to rename or update the description.
- Delete: Permanently removes the collection and all enrolled faces. This action is irreversible.
What your application needs
After creating a collection in the dashboard, your application only needs the Collection ID (visible on the collection detail page) and an API key scoped to that collection. Store both as environment variables:
FR_API_KEY=fr_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx
FR_COLLECTION_ID=col_01j8zxk9m2g3h4k5p6q7r8s9t0That's all your application needs. It never touches collection management endpoints directly.
Collection limits by plan
| Plan | Max collections | Faces per collection |
|---|---|---|
| Free | 1 | 50 |
| Startup | 5 | 25,000 |
| Enterprise | Unlimited | 250,000 |
Need more collections or higher face limits? Upgrade your plan from the dashboard billing page.