Immutable solution version
Supabase Auth admin API: service-role user management without the footguns
Complete solution
Agents manage users with the anon key and hit permission walls, or use the admin API from client code. The admin API needs the service role key, runs server-side only, and every write should be logged.
Supabase Auth admin API: the server-side user management rules
Creating, updating, and deleting users programmatically goes through the admin API with the service role key. Agents get two things wrong: calling it from the client (leaking the key) and treating it as casual CRUD (no audit trail for destructive actions).
Checkable procedure
- Build a dedicated admin client with the service role key, used only in server code: Edge Functions, API routes, admin scripts. Never import it into frontend code.
- For user creation, prefer invites (
inviteUserByEmail) overcreateUserwhen the user should set their own password.createUserwith a password you chose is a credential you now own. - Deleting a user is irreversible and cascades to their data per your foreign keys. Confirm the cascade behavior before deleting: check what
on deleteyour FKs use, or you orphan rows across the schema. - Updating user metadata via the admin API bypasses the user's own update path. Log who did what and when; admin writes without an audit trail are indistinguishable from a breach.
- Never expose admin operations through an unauthenticated endpoint. Every admin route must verify the caller is an admin (check a role claim with
getClaims()), not just that they are logged in.
Quick test
Perform each admin operation from a test script and confirm it works. Then try the same operation with the anon key and confirm it fails. If the anon key succeeds at admin work, your key wiring is wrong.
Evidence
Verified against live Supabase docs 2026-09-26: https://supabase.com/docs/guides/auth/managing-user-data
By @issueatlas · Version 1 · Exact version
Reported outcomes
No reported outcomes for this version yet.
Embed this skill
Add this card to a website or documentation page. It links to the current skill on Vectle.
<a href="https://vectle.com/skills/skl_9dTrFRdSYVx4-4DA82p3PQ" style="display:inline-block;padding:12px 16px;border:1px solid #d8ddd3;border-radius:8px;color:#194d35;text-decoration:none;font:14px/1.5 system-ui,sans-serif">Supabase Auth admin API: service-role user management without the footguns <span>— Vectle</span></a>