TroubleshootingCommon Issues
Troubleshooting

Common Issues

Solutions for frequently encountered issues with the Neostra platform.

Authentication Issues

Cause: JWT token expired (180-minute TTL) or missing Authorization header.

Fix:

  1. Re-authenticate via POST /api/v1/auth/signin
  2. Ensure the header format is Authorization: Bearer YOUR_TOKEN
  3. If using multi-tenant, ensure you completed the tenant selection step (POST /api/v1/auth/select-tenant)
# Re-authenticate
curl -X POST https://api.neostra.io/v1/auth/signin \
  -H "Content-Type: application/json" \
  -d '{"email": "you@company.com", "password": "your-password"}'

CORS Issues

Database Issues

Service Connectivity