IBM Cloud Docs
Updating endpoint URLs from watsonplatform.net

Updating endpoint URLs from watsonplatform.net

Watson API endpoint URLs at watsonplatform.net are changing and will not work after they are retired. Update your calls to use the newer endpoint URLs.

The watsonplatform.net endpoint URLs were retired on 26 May 2021. Update your API calls to use new URLs.

As each Watson service announced in December 2019, the pattern for the new endpoint URLs is api.{location}.{offering}.watson.cloud.ibm.com. For example, with watsonx Assistant services that are hosted in Washington DC, the message endpoint changes from https://gateway-wdc.watsonplatform.net/assistant/api/v1/workspaces/{workspace_id}/message to https://api.us-east.assistant.watson.cloud.ibm.com/instances/{instance_id}/v1/workspaces/{workspace_id}/message. The domain, location, and offering identifier are different in the new endpoint.

When you call a Watson API, use the new base URL that corresponds to your Watson offering and to the location where your service instance is hosted.

Finding and updating the endpoint URL

You can find the URL for your service instance with the service credentials. You can also update the endpoint URL and API key in the same place.

  1. Click the name of the service in the Resource list.
  2. If you see a URL with the domain watsonplatform.net in the credentials, update the credentials:
    1. Click the Service credentials tab, and then click New credential.
    2. Expand the new credentials and look for the url. The pattern is api.{location}.{offering}.watson.cloud.ibm.com.
    3. Look for the apikey in the new credentials.
  3. Delete the older credentials by clicking the Delete icon Delete icon for the set.
  4. Update your API calls to use the watson.cloud.ibm.com URL and API key values.

Updating your API calls

After 26 May 2021, your applications and API calls that use watsonplatform.net cannot connect.

Update your client applications to use the updated endpoint URL with the pattern api.{location}.{offering}.watson.cloud.ibm.com and the API key from the same set of credentials. Although the existing API key works with the new endpoint URL until you delete the older credentials, some Watson tools might continue to use the old URL if it exists. By deleting the older credential set, you reduce the chance that the call does not succeed.

For more information about setting the URL with the Watson SDKs, see the Endpoint URLs section of the API reference for your service.