Troubleshooting

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

Identify the type of error encountered (authentication, request, server)
Verify your configuration (workspace, API key, scopes)
Consult the known solutions for common errors
Contact support with the necessary information if the problem persists

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 requestId from 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