For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Open sourceSupportFAQsDocs Home
  • Introduction
    • Overview
    • Retired adapters
      • Overview
      • Result codes
      • Connectivity
      • Authentication
      • Connectivity
      • Dependencies
      • Installation location
      • URL paths
        • Adapter not in Itential Platform
        • Adapter status is red
        • No calls working
        • DEPTH_ZERO_SELF_SIGNED_CERT
        • Wrong response data
        • Wrong request data
        • One or more calls failing
        • Tasks not in Platform
        • Troubleshoot linting and testing
LogoLogo
Open sourceSupportFAQsDocs Home
On this page
  • Issue
  • What to check
TroubleshootSpecific scenarios

Adapter is up but no calls are working

Was this page helpful?
Previous

DEPTH_ZERO_SELF_SIGNED_CERT error

Next
Built with

Issue

The adapter appears to be running but none of the adapter calls succeed.

What to check

Verify the health check is working first. In some adapters, the health check is set to none by default. If that is the case, enable it and confirm it passes. If the health check fails, follow the steps in Adapter status is red — connectivity and authentication problems at the health check level will affect all calls.

Check base_path and version. If the health check was customized to use a different path than other calls, it may work while everything else fails. Verify that base_path and version are set correctly for all calls, not just the health check. See URL paths.

Enable debug logging. Debug logs are essential for understanding exactly what the adapter is sending and receiving. Enable debug-level logging inItential Platform Admin Essentials for the adapter, then review the logs. To isolate a specific call, configure the integration test to run it against the real system and set the log level in package.json.

Test a call independently. Run the equivalent request in Postman or with curl to confirm what a successful request and response look like. Compare this to the adapter’s behavior in the logs.

Review the endpoint configuration. If specific calls need adjustment, changes may be required in the service instance configuration or in action.json for the relevant entity at /adapter-home-dir/entities/<entity-name>. Be careful not to break the health check or getToken when changing shared service instance configuration values.

If the logs do not identify the cause, contact the Itential Adapters Team with the log output.