api-management-developer-portal icon indicating copy to clipboard operation
api-management-developer-portal copied to clipboard

Developer Portal uses built-in gateway hostname instead of custom domain for API endpoints and “Try it” requests

Open man-tas opened this issue 3 months ago • 3 comments

Bug description

The Developer Portal displays and uses the built-in gateway hostname (e.g., https://<service-name>.azure-api.net) for API endpoints and “Try it” requests, even when a custom Gateway domain is configured and working. Testing the API from the Azure Portal “Test” tab uses the custom domain correctly; only the Developer Portal keeps showing and calling the built-in URL.

Image

Reproduction steps

  1. Configure a custom domain for the Gateway (e.g., api.example.com) in APIM and verify it’s working (valid cert, DNS OK).
  2. Publish an API with base path (e.g., /v1).
  3. Open the Managed Developer Portal and navigate to the API details page.
  4. Observe the endpoint shown in the header/samples and in the Try it console.
  5. Send a request via Try it.
  6. Compare with the same API called from Azure Portal → APIM → APIs → Your APITest tab (which uses the custom domain).

Actual behavior

  • Developer Portal displays and calls the API using the built-in hostname https://<service-name>.azure-api.net/....
  • The Host and request URL in the browser’s dev tools also reflect the built-in hostname.

Expected behavior

  • Developer Portal should display and use the configured custom Gateway domain (e.g., https://api.example.com/...) in the UI, samples, and “Try it” requests — or provide a clear setting to choose which hostname to use.

Is self-hosted portal?

No (Managed Developer Portal).

man-tas avatar Oct 31 '25 11:10 man-tas

@Onatolich any ideas?

man-tas avatar Nov 03 '25 20:11 man-tas

I would like to add a vote to this. I am also seeing this issue, and it effecting the communication of a production release

tlonergan avatar Nov 07 '25 18:11 tlonergan

I was having this issue up until yesterday, but it seems to have fixed itself now?

scottmckendry avatar Nov 11 '25 18:11 scottmckendry