Troubleshoot integration health issues

If an integration shows an Error status, use the following steps to diagnose and resolve the issue.

Step 1: Verify the endpoint

  1. Navigate to Configuration > Integrations.
  2. Click the integration name to open its details page.
  3. Verify that the API URL is correct.
  4. Click Edit integration, then click Test connection to run a manual connectivity check.

Step 2: Check the health check credential

If the connection test returns an authentication error:

  1. Verify that the health check credential has not expired or been revoked at the provider.
  2. Re-enter the health check credential in the integration configuration.
  3. Click Test connection to confirm.

Step 3: Check network connectivity

If the connection test times out:

  1. Verify that the external endpoint is operational (check the provider's status page if applicable).
  2. Verify that the automation orchestrator can reach the endpoint from its network. Check firewall rules, proxy configuration, and DNS resolution.

Step 4: Review workflow impact

If workflows are failing due to an unhealthy integration:

  1. Identify which workflows use the affected integration.
  2. Pause or disable affected workflows until the integration is restored.
  3. After resolving the issue, verify that the integration returns to Available status before resuming workflows.
Note:

An integration can show Available status while the LLM provider experiences transient connectivity issues. If Task Agent steps are failing but the integration appears healthy, see the "LLM provider unreachable during execution" entry in Resolve common workflow failures.