Skip to main content

​
OpenAI

The fallback provider for anomaly analysis and OpenAPI spec analysis when Anthropic is not configured, and one of the answer engines the platform’s AI-visibility probes query. Scope: Global defaults only. Workspace AI features use the workspace’s Anthropic key; this card is for the platform operator (KnoxCall on Cloud, you on a self-hosted deployment).

​
1. In the OpenAI Platform

  1. platform.openai.com → select or create the project that should own the spend.
  2. API keys → Create new secret key → Project key, scoped to that project.
  3. Permissions: Restricted, granting Model capabilities: Write (chat completions) and Models: Read (the health probe lists models).
  4. Copy the key (sk-proj-…) — shown once.

​
2. Enter it in KnoxCall

Settings → Integrations → Global defaults → OpenAI → Configure: Save credentials.

​
3. Verify

With no Anthropic key configured, run AI analysis on an alert; it falls through to OpenAI. The operator console’s Test connection lists models with the stored key — a key without Models: Read fails that test while still working for completions.

​
Things that bite

  • A stored key wins over OPENAI_API_KEY on a self-hosted host; the variable is only the fallback when no row exists.
  • Project keys, not legacy user keys. A user key carries the person’s full access and dies with their account.