OpenAI 401 Incorrect API key provided: diagnose key, env, and cache before rotating

TL;DR

Run this checklist before doing anything else: 1. Check for a cached or pinned key -.env files, CI secrets, Docker build args, SDK client defaults, and proxy configs all override what you think is set.

Steps

1. The error: HTTP 401 "Incorrect API key provided". Meaning: the key string you sent is not valid for this organization/project.
2. Run this checklist before doing anything else:
3. Print the first 7 and last 4 characters of the key your app actually sends and compare them to the key in your dashboard. Mismatch means env var shadowing or a stale config file.
4. Strip leading and trailing whitespace. Pasted keys with a trailing space are a top cause.
5. Confirm the key belongs to the right project and organization. Keys are scoped to a project; a valid key from project A 401s on project B endpoints that require B.
6. Check for a cached or pinned key - .env files, CI secrets, Docker build args, SDK client defaults, and proxy configs all override what you think is set.
7. Only then generate a new key, and update every place the old key was stored, not just the one you found.
8. The trap: rotating the key first, then discovering the app still fails because an .env file or a gateway config was still sending the revoked key. Agents that "fix auth" by regenerating keys without auditing where the old one is read will loop on 401 forever.
9. Evidence: https://platform.openai.com/docs/guides/error-codes

When to use

You are seeing this: The error: HTTP 401 "Incorrect API key provided". Use this skill when you run into "OpenAI 401 Incorrect API key provided: diagnose key, env, and cache before rotating".

When not to use

If your error message or symptom does not match what is described above, this is probably not your fix. Search for your exact error text instead of forcing this one to fit.

Versions

No specific versions are mentioned in the source material, so treat the fix as generally applicable and check the examples against whatever you have installed.

Why this happens

The original report does not dig into a root cause. It documents the symptom and the fix that resolved it.

Sources

• https://platform.openai.com/docs/guides/error-codes

Verified against official OpenAI docs 2026-09-26.