Find your symptom, then follow the fix. For a specific code, see winget errors, Agent and epw exit codes or API errors.
| Symptom |
Likely cause |
Fix |
| Approve is disabled |
Checks haven’t finished, a finding at or above your policy, a failed malware scan, or a blocking rule |
The reason is next to the button. See Review and approve a version. |
| A version is Blocked after approval |
A new finding or rule matched it |
Check Security › Findings. Fix the cause or add an exception. |
| An approved version went back to Pending review |
Its manifest or installer hash changed upstream |
Review it again. The approval covered the old installer. |
| Could not verify on the hash |
The download failed, or the installer is over the 300 MB limit |
Choose Analyze again. Large installers stay unverified; winget still checks the hash on the device. |
| Mismatch on the hash |
The vendor file doesn’t match the manifest |
Don’t approve. Wait for a corrected manifest. |
| A package isn’t in Discover |
It isn’t on the community allowlist |
Upload it, or ask support. |
| Symptom |
Likely cause |
Fix |
No package found matching input criteria |
Not approved, blocked, or wrong source name |
Check Approvals, then winget source list. |
| The source stopped answering on some devices |
Their source key was revoked |
Add a new key to those devices. |
winget source add fails |
No HTTPS route to the API host, or not elevated |
Run elevated. Check proxy and TLS inspection. |
Uninstall fails with 0x8A15007D |
A portable app was installed in user scope |
Reinstall with --scope machine. |
| Requests fail with HTTP 429 |
More than 1,200 requests a minute on one key |
Spread requests, or use one key per channel. |
| Symptom |
Likely cause |
Fix |
| A device never appears |
Wrong server URL or token, or no HTTPS route |
Run ew-agent diagnose as administrator. |
| Intune reinstalls the agent in a loop |
Detection by MSI product code |
Detect the registry Version value. See Deploy the agent. |
| A plan notice instead of a feature |
Your plan doesn’t include it |
See Plans and features. |
epw exits 23 |
Requests or self-service are off, or the package is required or Intune-owned |
Check Organization › General. |
| Symptom |
Likely cause |
Fix |
| Passwords stopped working |
SSO enforcement is on |
Sign in with your identity provider. |
| “Ask EndpointWorks support to finish SSO setup” |
Federation isn’t finished |
Contact support. |
| A person’s role keeps resetting |
A group mapping sets it at sign-in |
Change the role in the console once; it wins after that. |
Email [email protected] with your organization name, the time, the page or command, and the exact message or code.