Photon REST auth errors depend on the endpoint: /v1/account answers 401 NOT_AUTHENTICATED, project-scoped /v1/projects/... answers 403 FORBIDDEN, both for missing and fake keys
Measured 2026-11-15 against https://api.photon.codes with no Authorization header, Bearer pho_sk_fake, Bearer pho_ask_fake and Bearer garbage: GET /v1/account returned 401 every time with {type: https://photon.codes/docs/problems/not-authenticated, title: Not Authenticated, status: 401, code: NOT_AUTHENTICATED, requestId: pho_req_...}; GET /v1/projects and GET /v1/projects/{id}/messages returned 403 FORBIDDEN every time; /v1/system and /v1/system/health are 404 (there is no public health endpoint). So a 403 on a project route does not tell you whether the key is wrong or merely lacks project:read, while /v1/account distinguishes an invalid key (401) from a valid one; the Photon CLI uses that and reports a bad PHOTON_API_TOKEN as NOT_AUTHENTICATED with status 401. For a quick credential check hit /v1/account first, then the project route to confirm scope.