Administration API keys Secrets

Secrets

Forgebench stores each model provider credential once, encrypted, and adds it to outbound calls. Your code authenticates with its own API key, never the provider's. To revoke a compromised provider credential, remove it here; nothing needs redeploying.

Voice models use the same store. Label the key:

  • openai for the OpenAI transcription and speech models
  • deepgram for nova-3
  • elevenlabs for the ElevenLabs voices
  • gemini, or a Vertex credential, for the Google audio models See Govern your voice agent.

Google Vertex AI takes a service-account JSON instead of an API key; see Google Vertex AI.

The built-in test model, mock-gpt, needs no provider credential and costs almost nothing. Use it while you build.

How secrets are stored

PropertyWhat it means
EncryptedEncrypted at rest with a key bound to your workspace.
Write-onlyThe API reports which providers are configured, never the key itself, to anyone.
Injected at call timeForgebench adds the credential to the provider request. Your requests and logs never carry it.
AuditedSetting or removing a credential is recorded in the audit log.
One row per provider. The secret column never shows the key, only that a vault entry exists.
One row per provider. The secret column never shows the key, only that a vault entry exists.

The Coverage panel shows how many catalog providers are configured, how many models are reachable, and how many are stranded: in the catalog but unreachable because their provider has no credential.

Add a credential

  1. Open Secrets

    In the sidebar, expand Admin and choose Secrets.

  2. Choose a provider

    The list shows only providers in the gateway's model catalog.

  3. Paste the key and store it

    The value is never shown again. You can replace it, not recover it.

Add provider credential — the key is write-only from the moment it's pasted
Add provider credential — the key is write-only from the moment it's pasted

Adding or replacing a provider credential requires the admin role.

Remove a credential

Type the provider's name to enable the remove button. Removal is permanent: calls to that provider fail until you store a new key. Removal is audited.

Next

Cookie settings

Our Cookie Policy lists every cookie and what it does.