Why switch providers
Common reasons:- Cost. One provider’s rates fit your team’s usage pattern better than the other’s.
- Existing relationships. Your organisation already uses one provider for other workloads; consolidating reduces administrative overhead.
- Compliance. Specific regulatory or contractual requirements favour one provider.
- Outage failover. The current provider is down; you want Henry working again immediately.
Switching, in detail
Create the new API key
In the new provider’s dashboard, create an API key. See Setting up Henry for the provider-specific steps. Set a usage cap to match your expectations.
Open Henry settings in Brand Atlas
Settings → AI → Henry. The current provider and key status are shown.
Replace the key
Click Replace key. Choose the new provider. Paste the new key. Click Test and save.Brand Atlas tests the new key against the new provider. On success, the old key is removed from Brand Atlas’s Vault in the same operation; the new key takes over.
Revoke the old key (recommended)
In the old provider’s dashboard, revoke the old key. Optional but good practice: a key that is no longer in active use should not still be valid.
What changes for the team
For the team, almost nothing changes:- Henry is still in the same place (bottom-right chat icon).
- Henry answers the same kinds of questions.
- The conversation history from before the switch is preserved.
- Citation format is the same.
- Response style. Each provider’s models have subtle differences in phrasing. The overall voice is consistent because Brand Atlas’s system prompt is consistent; the micro-style varies.
- Response time. Different providers and models have different latencies. Differences are typically a few hundred milliseconds.
- Edge-case behaviour. When pressed on unusual questions, the providers behave slightly differently. Most teams do not notice.
Setting up tested failover
For teams whose tolerance for Henry downtime is low (organisations that rely on Henry for live work, support teams, multi-time-zone operations), a tested failover setup is useful. The setup:- Have accounts with both providers. Active accounts with valid API keys on both OpenAI and Gemini.
- Document the failover procedure. A one-page runbook stored alongside Brand Atlas operational documentation. Names, the steps, the expected time to switch.
- Test quarterly. Run a controlled failover once per quarter to ensure the runbook still works.
When the current provider is partially degraded
A provider can be slow without being down. Common signs:- Henry responses are taking 15+ seconds.
- Rate limit messages are appearing despite normal usage.
- The provider’s status page shows incidents on the relevant model.
- Wait. Most degradations resolve within hours.
- Switch. Move to the other provider for the duration; switch back when the original is restored.
What happens to conversation history on switch
Conversation history is stored by Brand Atlas, not by the provider. Switching providers preserves history. The team member’s past conversations remain available; new conversations are processed by the new provider. If the customer ever wants to delete past conversations (a data-handling requirement, a clean-up), this is done from Settings → AI → Henry → Conversation history and is independent of the provider switch.Cost reconciliation across providers
If you switch mid-month, you will receive a partial-month bill from the old provider and a partial-month bill from the new one. Both will be smaller than a full month at either; the total is roughly the same as a full month at one. Brand Atlas does not aggregate the bills; the customer reconciles with each provider directly.Switching back
A switch back is identical to a switch forward. Paste the previous provider’s key (or a freshly created one); the new provider’s key is replaced. There is no limit on how often you can switch. Most customers switch zero or one times in the life of an atlas; some switch back and forth based on cost optimisation.Related pages
Setting up Henry
The initial setup.
Rotating and revoking
Routine key management.
Costs and rate limits
The cost picture.