Troubleshooting

Symptom → first check → the page that explains it. Not a second copy of those pages.

Setup and SDK

Symptom	Likely cause	See
Empty or sparse generate	Wrong key/env, missing Generate Library, --contexts filter	Quickstart, Generated SDKs
Functions “vanished”	CLI pointed at the wrong instance (na1 vs eu1)	Re-run poly setup; TypeScript CLI reference
VS Code extension setup fails	Node/OS/key	Quickstart Path B (CLI)

Auth

Symptom	Likely cause	See
Lost API key	Shown once	Mint a new key: Managing Users and API Keys
Permission denied	Key lacks the flag	API Key Permissions
User exists, cannot log in	No key, or SSO Application not PUBLIC	Authentication model, Setting up Single Sign-On

Training

Symptom	Likely cause	See
Train succeeded, execute 404	Missing --hostUrl / --hostUrlAsArgument	Using OpenAPI Specs
Train overwrote a function	Upsert on same context+name	OpenAPI train warning
python -m polyapi model missing	No Python OpenAPI CLI	Using Postman or TypeScript CLI
Expected json-placeholder-spec.json	Output is slugified info.title	Using OpenAPI Specs

Runtime

Symptom	Likely cause	See
Job failed ~10 min; function still running	Job wait budget vs Knative timeout	Limits and timeouts
Webhook always returns stub JSON	No Wait for Response trigger	Managing API Endpoints (Webhooks)
HTTP 429	Rate / inventory cap, not a timeout	Limits and timeouts
Server function logs empty	Logs Enabled false, or looking at a client function	Logging
Webhook body empty	Binary / unsupported Content-Type	Webhook Security Functions