---
name: watson-endpoints-change
title: Updating endpoint URLs from `watsonplatform.net`
description: 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.
last-updated: 2022-01-04
---

> ## Documentation Index
> The table of contents for this documentation set is at https://cloud.ibm.com/docs/watson?format=markdown
> The index for all IBM Cloud docs is at: https://cloud.ibm.com/docs/llms.txt
> Use these files to discover more information as needed.

# Updating endpoint URLs from `watsonplatform.net`
{: #endpoint-change}

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.
{: shortdesc}

The `watsonplatform.net` endpoint URLs were retired on 26 May 2021. Update your API calls to use new URLs.
{: deprecated}

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
{: #endpoint-find-update}

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](https://cloud.ibm.com/resources?groups=resource-instance){: external}.
1.  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**.
    1.  Expand the new credentials and look for the `url`. The pattern is `api.{location}.{offering}.watson.cloud.ibm.com`.
    1.  Look for the `apikey` in the new credentials.
1.  Delete the older credentials by clicking the **Delete** icon ![Delete icon](../icons/delete.svg "Delete") for the set.
1.  Update your API calls to use the `watson.cloud.ibm.com` URL and API key values.

## Updating your API calls
{: #endpoint-update-code}

After 26 May 2021, your applications and API calls that use `watsonplatform.net` cannot connect.
{: important}

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](https://cloud.ibm.com/docs?tab=api-docs&category=ai) for your service.

## Information about other services
{: #endpoint-links}

watsonx Assistant integrations: For more information about how to update endpoint URLs (including web chat, Slack, Facebook Messenger, Jupyter Notebooks), see the [watsonx Assistant release notes](https://cloud.ibm.com/docs/assistant?topic=assistant-release-notes&format=markdown#assistant-apr062021).