nothiro/cereal-applicant-api

1---2title: Cereal Applicant API3emoji: 🥣4colorFrom: purple5colorTo: yellow6sdk: docker7app_port: 78608pinned: false9---10 11# Cereal Applicant API12 13Backend API powering the Cereal Applicant platform.14 15## Environment Variables16 17Set the following secrets in your HF Space settings:18 19| Variable | Required | Description |20|---|---|---|21| `CLERK_ISSUER` | ✅ | Clerk JWT issuer URL (e.g. `https://your-app.clerk.accounts.dev`) |22| `CLERK_SECRET_KEY` | ✅ | Clerk backend API key |23| `CLERK_WEBHOOK_SECRET` | ✅ | Clerk webhook signing secret |24| `ES_CLOUD_ID` | ✅ | Elasticsearch Serverless Cloud ID |25| `ES_API_KEY` | ✅ | Elasticsearch API key |26| `ES_AGENT_ENDPOINT_ID` | ✅ | ES Agent Builder inference endpoint ID |27| `ANTHROPIC_API_KEY` | ✅ | Anthropic API key (for Haiku summaries) |28| `NOTION_CLIENT_ID` | ❌ | Notion OAuth app client ID |29| `NOTION_CLIENT_SECRET` | ❌ | Notion OAuth app client secret |30| `NOTION_REDIRECT_URI` | ❌ | Notion OAuth redirect (this Space's URL + `/auth/notion/callback`) |31 32## Endpoints33 34- `GET /health` — liveness check (no auth)35- `POST /knowledge/*` — index knowledge sources36- `GET /POST /agent/*` — agent control37- `GET /applications` — list applications38- `GET/PUT /preferences` — user preferences39- `GET/POST/DELETE /allowlist` — allowed sites40- `POST /responses/sync` — app-open email sync41- `GET /responses/counts` — dashboard stats42