This browser is no longer supported.
Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
![](data:image/svg+xml, %3Csvg xmlns='http://www.w3.org/2000/svg' height='64' class='font-weight-bold' style='font: 600 30.11764705882353px "SegoeUI", Arial' width='64'%3E%3Ccircle fill='hsl(288, 88%, 37%)' cx='32' cy='32' r='32' /%3E%3Ctext x='50%25' y='55%25' dominant-baseline='middle' text-anchor='middle' fill='%23FFF' %3EHL%3C/text%3E%3C/svg%3E)
I want to unlink and relink an API from a Static Web App, but the Unlink button is not working (it does nothing). I recently added a custom domain with TLS to the static web site, and as soon as I did the Azure function link stopped working. I want to try to re-link it to see if I that will fix it.
![](data:image/svg+xml, %3Csvg xmlns='http://www.w3.org/2000/svg' height='64' class='font-weight-bold' style='font: 600 30.11764705882353px "SegoeUI", Arial' width='64'%3E%3Ccircle fill='hsl(259.20000000000005, 6%, 35%)' cx='32' cy='32' r='32' /%3E%3Ctext x='50%25' y='55%25' dominant-baseline='middle' text-anchor='middle' fill='%23FFF' %3EDA%3C/text%3E%3C/svg%3E)
Why This Happens:
• The Unlink button sometimes breaks due to portal UI bugs, especially after:
• Adding custom domains
• TLS/HTTPS changes
• Recent deployments
• The API link metadata might be in a broken state, so the portal can’t process the unlink action
Solutions
1. Use Azure CLI to unlink and re-link manually
Unlink:
az staticwebapp disconnected-api --name <YourStaticWebAppName> --resource-group <YourResourceGroup>
Re-link:
az staticwebapp linked-api --name <YourStaticWebAppName> --resource-group <YourResourceGroup> --api-resource-id <AzureFunctionResourceId>
You can find the <AzureFunctionResourceId> in the Properties blade of the Function App.
2. Or use ARM Template / Bicep update
If you’re using infrastructure as code, remove the API link reference and redeploy.
Tip:
After unlinking and re-linking, redeploy your Static Web App or restart the Function App to ensure it registers properly with the new settings.
@Doaa Ali Hamdan AL-Jarwani Please update this answer as well as your other answers/comments to comply with AI Usage policy for Microsoft Q&A.
For example, you could start by clearly stating at the top of each answer that it is generated in whole/part by AI and detail which AI was used, similar to below:
AI generated content. This answer was created with AI from ChatGPT
Additionally, please make sure you comply with the other key elements of the policy, excerpted below:
Follow these steps when using AI to generate an answer on Q&A:
- Mention the AI service name that generated the answer, fully or partly.
- Check the AI output accuracy and relevance and adjust it as needed. Indicate you validated or updated the AI output in your answer.
- Include any sources AI generated or you used as you validated and updated the AI output.
Using AI to help with answers on Microsoft Q&A requires following these three steps. Otherwise, moderators might delete the content and suspend your account.
Thank you.
Your command was incorrect. The correct command is:
az staticwebapp functions unlink --name <YourStaticWebAppName> --resource-group <YourResourceGroup>
but unfortunately this did not fix anything. I re-linked using the Azure Portal, but it still does not work. There must be something wrong with the routes.
To provide more context, I am running the Azure URL Shortener, https://github.com/microsoft/AzUrlShortener, which I did a custom deployment using the magic button they used to provide (deploys using GitHub actions). The whole thing broke when I set up a custom domain with SSL and the link to the Azure function from the Static Web Site stopped working.
I will upgrade my private repo to the latest version, backup the data, delete the old deployment, and redeploy from scratch (and restore data). Hopefully that will fix it.
![](data:image/svg+xml, %3Csvg xmlns='http://www.w3.org/2000/svg' height='64' class='font-weight-bold' style='font: 600 30.11764705882353px "SegoeUI", Arial' width='64'%3E%3Ccircle fill='hsl(144, 36%, 23%)' cx='32' cy='32' r='32' /%3E%3Ctext x='50%25' y='55%25' dominant-baseline='middle' text-anchor='middle' fill='%23FFF' %3ESH%3C/text%3E%3C/svg%3E)
Hi@Henry LaFleur
It appears that you're having trouble unlinking and relinking your API from the Static Web App. If the Unlink button isn't working, it might be a temporary issue with the Azure portal or a configuration problem.
If the unlinking process doesn't complete successfully, check for any errors or notifications in the Azure portal for more details.
After unlinking, you can relink the Azure Functions app
Ensure that the api_location value in the workflow configuration is set to an empty string before linking the existing Functions application.
References: