At a glance
This guide helps you diagnose and resolve common issues encountered with Ontologie. Follow the quick diagnostic checklist to identify the source of the problem, then consult the detailed solutions.
What you'll do
Quick diagnostic checklist
Before going further, check these five points:
- Workspace and space -- Verify that you are connected to the correct workspace and that you have selected the right space.
- API key -- Verify that your API key is active and that it has the required scopes (for example
read:nodes,write:nodes). See API Keys. - Active source or workflow -- If the issue concerns a data source or a workflow, verify that it is active and not paused.
- Common errors -- Check the Common errors page to find your error code and the associated solution.
- Contact support -- If the problem persists, contact support and include the
requestIdfrom the error response.
Common HTTP codes
| Code | Meaning | Probable cause |
|---|---|---|
| 400 | Bad Request | Invalid or missing parameters in the request |
| 401 | Unauthorized | API key invalid, expired, or missing |
| 403 | Forbidden | Insufficient scopes on the API key |
| 404 | Not Found | The entity, workflow, or resource does not exist in this workspace |
| 409 | Conflict | Simultaneous modification : reload and retry |
| 429 | Too Many Requests | Rate limit reached : wait a few seconds |
| 500 | Internal Server Error | Server error : include the requestId in your report |
| 502 | Bad Gateway | Service temporarily unavailable : retry after a few moments |
Recommended paths
Expected outcome
Related views / modules
- Common errors : Detailed error codes and solutions
- Live Data troubleshooting : Connector troubleshooting
- API Keys : Key management and verification
- Dashboard : System diagnostics and health
Need help?
Write to us: Support and contact.