Projects
Project Troubleshooting
Diagnose invalid project identifiers, domain mismatch errors, quota exhaustion, and environment collisions.
Overview
Troubleshoot project workspace provisioning, domain matching, and key validation issues.
Error: Project ID Not Found
Cause
The projectId string contains typos or references a deleted project workspace.
Fix
- Open the Asiyst Dashboard and confirm the exact ID in Project Settings.
- Verify that your
.envfile in Next.js does not contain extraneous quotation marks or trailing spaces:NEXT_PUBLIC_ASIYST_PROJECT_ID=proj_9f8a2b3c4d
Error: Origin Not Permitted (403)
Cause
The browser's window.location.origin is not on the project's Allowed Domains whitelist.
Fix
- Add
http://localhost:3000or your exact production domain to Project Settings > Allowed Domains.
Quota Exhaustion & Billing Holds
If assistant handshakes return 429 Rate Limit Exceeded:
- Check monthly message quota under Settings > Billing.
- Upgrade your subscription tier or enable pay-as-you-go overages.
Project Diagnostics Checklist
# Run automated CLI validation
asiyst validate --project proj_9f8a2b3c4d