Technical

Providers

Bring-your-own-key provider management for external model providers and model availability inside CaveauAI.

Open in app All docs

Public and internal interfaces

These are the main routes, handlers, and integration surfaces used by this product area.

GET/POST /api/portal/providers GET/PATCH/DELETE /api/portal/providers/{id} GET/PATCH /api/portal/providers/{id}/models GET /api/portal/providers/usage GET /api/portal/providers/models

Architecture notes

Provider hooks live in caveauai-web/src/lib/providers.ts.
Secrets must be encrypted or masked server-side; docs must never include real keys.
Active BYOK models are surfaced to Research Chat.

Access and permissions

App pages are authenticated through the shared bnl_session cookie unless explicitly marked public. Public docs should describe integration behavior without including secrets, private tokens, private IPs, or tenant-specific records.

Troubleshooting

A model list failure often means the provider key or base URL is wrong.
If a BYOK model appears unavailable in chat, confirm it is enabled in Providers.