| "<Provider> rejected this key (invalid key). Nothing was saved; the previous key (if any) is still in use." (for Azure: "invalid key or wrong region") | The provider refused the key when the panel tested it | Copy the key again. For Azure, check the region. See AI keys. |
| "<Provider> region not found — check the region name. …" | The Azure region name is wrong | Use the region name from the Azure portal |
| "<Provider> says this key is out of quota or rate-limited, so it was not saved. Add credit / wait, then try again. …" | No credit, or the provider is busy | Add credit or wait, then save again |
| "Could not reach <Provider> to check this key, so it was not saved. Try again in a few minutes. …" | The provider did not answer the test | Try again in a few minutes |
| "OpenAI API key not configured. Connect OpenAI in Integrations first." | A feature needs OpenAI and no key is saved | Connect OpenAI in AI → Integrations |
| OpenAI key needed with an Add key button (knowledge base) | You added, re-processed or edited knowledge base content with no OpenAI key. The knowledge base always needs OpenAI for search, even with a Claude model | Click Add key and connect OpenAI |
| An AI key is missing / Some AI keys are missing in the knowledge base AI models dialog | No OpenAI key (needed for search), or a Claude model is picked with no Anthropic key | Click Go to AI integrations and add the key, or pick an OpenAI model |
| You can't remove this key when removing a key | Only workspace managers can remove AI provider keys | Ask a manager |
| OpenAI key is still in use (or another provider) | A legacy data source still uses the key | Migrate or delete it under Legacy Sources, then remove the key. See AI keys. |
| Too many key changes | Keys can be changed 5 times per hour | Wait, then try again |
| "The API key was rejected" (Agent Studio) | The agents' key is wrong or revoked | Paste a new key in Agent Studio settings |
| "The provider account is out of credit" (Agent Studio) | No balance | Top up; conversations resume automatically |
model_provider_unconfigured when publishing | No provider is connected in Agent Studio | Connect one in Agent Studio → Settings |
| "Claude models need an Anthropic API key." (knowledge base AI models) | You picked a Claude model without an Anthropic key | Add it in AI → Integrations, or pick an OpenAI model |