Skip to main content

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:

  1. Workspace and space -- Verify that you are connected to the correct workspace and that you have selected the right space.
  2. 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.
  3. Active source or workflow -- If the issue concerns a data source or a workflow, verify that it is active and not paused.
  4. Common errors -- Check the Common errors page to find your error code and the associated solution.
  5. Contact support -- If the problem persists, contact support and include the requestId from the error response.
Common errors

HTTP codes, error messages, and step-by-step solutions.

API Keys

Check your keys, scopes, and permissions.

Support

Contact the team with all the necessary information.

Screenshots to produce (low priority)​

  • /img/screenshots/troubleshooting/01-error-example.png - In-product error example
  • /img/screenshots/troubleshooting/02-request-id-location.png - Where to find requestId

Expected outcome​

You have identified the source of the problem and applied the corresponding solution, or you have gathered the information needed to contact support.

Need help?​

Write to us: Support and contact.