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
Collections are created and managed through the dashboard. Management endpoints are CORS-restricted to the dashboard origin and cannot be called from external applications. Once a collection is set up, your application interacts with it exclusively via API keys.

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_01j8zxk9m2g3h4k5p6q7r8s9t0

That's all your application needs. It never touches collection management endpoints directly.

Collection limits by plan

PlanMax collectionsFaces per collection
Free150
Startup525,000
EnterpriseUnlimited250,000

Need more collections or higher face limits? Upgrade your plan from the dashboard billing page.