Troubleshooting

Common issues and their resolutions. If you don't find what you need here, contact us at hello@cheqpoint.co.

Checking SDK logs

bash
# Enable debug logging in the Python SDK
export CHEQPOINT_DEBUG=true
python3 main.py

Common Error Codes

cq_auth_invalid

The Connection Key provided is invalid or has been rotated.

Fix: Check your key in Dashboard → Developer.

cq_quota_exceeded

Your workspace has reached its monthly request limit.

Fix: Upgrade your plan in Settings → Billing.

cq_agent_paused

The AI Assistant has been manually paused by an admin.

Fix: Resume the Assistant in the dashboard.

cq_rate_limit

Too many requests sent in a short window.

Fix: Check for infinite AI loops in your code.

Webhook Issues

If you aren't receiving decision callbacks:

  • Check the Delivery Log in Settings → Integrations. It shows response codes and body for every attempt.
  • Ensure your endpoint is publicly accessible and returns a 200 OK within 5 seconds.
  • Verify your webhookUrl is correct in the initial checkpoint() call.

Requests not appearing

If your SDK call completes but no request appears in the dashboard:

  • An Auto-Approval Rule might be instantly approving the request. Check the "Approved" tab.
  • Check if you are using a Sandbox key. Sandbox requests are isolated and don't trigger real notifications.