Oracle Cloud Infrastructure Documentation


Skip to main content

Troubleshooting Guides for Calling APIs

Use these troubleshooting guides to diagnose and resolve issues related to calling APIs.

These API Gateway troubleshooting guides provide in-depth information about specific issues related to calling APIs, including symptoms, possible causes, and likely resolutions:

  • Token validation fails because token claims do not match the deployment policy
  • Authentication provider call failures surface as HTTP 500
  • Unexpected response codes are returned through API Gateway
  • API Gateway returns 5xx responses because it cannot reach the backend
  • OCI service API calls fail after being proxied through API Gateway
  • Forwarded and host-related headers sent to HTTP backends do not match backend expectations
  • opc-request-id values seen by the client, API Gateway logs, and backend do not match as expected
  • Copyright © 2026, Oracle and/or its affiliates.
  • About Oracle
  • Contact Us
  • Legal Notices
  • Terms of Use & Privacy
  • Document Conventions