Unable to update or, after delete, add my Teams app after a manifest update

Question

Unable to update or, after delete, add my Teams app after a manifest update

Russell H. DeGrove 6

After changing bots->supportsFiles to true I was able to upload my manifest but could not update the app version, even after quitting Teams and clearing the cache. After deleting it I could not add it back. I reverted to the last working manifest, updated the version number, published that, and still cannot add it. Error merely reads "Ask your IT admin to look into it and add this app for you." How do I troubleshoot this? I did add Files.Read and Files.Read.All to the app registration and granted consent. The last working version had those under authorization->permissions->resourceSpecific but I had missed setting supportsFiles to true.

Nivedipa-MSFT 3,991 Reputation points Microsoft External Staff Moderator

2026-04-01T05:47:07.8766667+00:00
Hello Russell H. DeGrove - Thanks for bringing this issue to our attention.
If you see "Ask your IT admin," this indicates a policy-level block rather than a manifest issue.

Go to Teams Admin Center → Manage apps and check if your app is blocked. If so, allow it.

In Setup policies, make sure "Upload custom apps" is enabled for your user.

After deleting an old app, wait 15 minutes before re-adding it to allow for server-side updates.

Check that both manifest.id and bots[0].botId match your Entra App Registration's Client ID.

Before uploading, validate your manifest at dev.teams.microsoft.com.

1 answer

Your answer

Nivedipa-MSFT 3,991 Reputation points Microsoft External Staff Moderator

2026-04-01T05:47:07.8766667+00:00

Hello Russell H. DeGrove - Thanks for bringing this issue to our attention.
If you see "Ask your IT admin," this indicates a policy-level block rather than a manifest issue.

Go to Teams Admin Center → Manage apps and check if your app is blocked. If so, allow it.

In Setup policies, make sure "Upload custom apps" is enabled for your user.

After deleting an old app, wait 15 minutes before re-adding it to allow for server-side updates.

Check that both manifest.id and bots[0].botId match your Entra App Registration's Client ID.

Before uploading, validate your manifest at dev.teams.microsoft.com.

Answer 1

Teddie-D 13,755 Microsoft External Staff Moderator

Hi @Russell H. DeGrove
According to Microsoft Teams apps update experience and admin role - Microsoft Teams | Microsoft Learn, changing supportsFiles in your Teams app manifest is treated as a capability and permission change. Once you upload that version, Teams requires admin approval before the app can be installed or updated. Reverting the manifest or clearing cache won’t bypass this requirement.

User's image

You have two supported paths forward:

1.Admin approval

A Teams admin can go to Teams admin center > Apps > Manage apps > Find your custom app by App ID > Review and Allow it.

Once approved, the app will immediately become installable again.

Reference: Manage your apps in the Microsoft Teams admin center - Microsoft Teams | Microsoft Learn.

2.Create a new app ID

If you don’t have admin access and want to keep testing:

-Generate a new id in the manifest

-Keep supportsFiles: true from the start

-Upload as a new custom app

I hope this helps.

If the answer is helpful, please click "Accept Answer" and kindly upvote it. If you have extra questions about this answer, please click "Comment".

Note: Please follow the steps in our documentation to enable e-mail notifications if you want to receive the related email notification for this thread.

Russell H. DeGrove 6 Reputation points

2026-04-01T14:07:47.79+00:00

Thanks! When I reverted to an old manifest with supportsFiles: false and no reference to file permissions and updated the version number, I was able to publish and use the app. I will get back to this in a day or so and see if I can approve after adding those back.
Teddie-D 13,755 Reputation points Microsoft External Staff Moderator

2026-04-02T01:45:12.9733333+00:00

Hi @Russell H. DeGrove

When you reverted to a manifest with supportsFiles: false and no file-related permissions, the app no longer included elevated capabilities, so the version update and installation went through without admin approval. Once you add supportsFiles: true again with the associated permissions, Teams will recognize this as a capability that requires admin consent. At that point, installation or update will require explicit approval from a Teams administrator, even if the app previously worked. Reverting the manifest works because it removes those elevated requirements, but adding them back will trigger the admin-approval requirement again.
Teddie-D 13,755 Reputation points Microsoft External Staff Moderator

2026-04-03T01:36:18.0966667+00:00

Hi @Russell H. DeGrove
Is there any update from you?
If yes, please feel free to let us know.
Russell H. DeGrove 6 Reputation points

2026-04-03T13:11:47.3466667+00:00

Sorry to keep you hanging. I got pulled onto other work, hope to be back to this project next week. Thank you!
Teddie-D 13,755 Reputation points Microsoft External Staff Moderator

2026-04-05T23:34:03.44+00:00

Hi @Russell H. DeGrove
Thank you for letting us know. We’ll await your update once you’re back on the project.

Share via

Unable to update or, after delete, add my Teams app after a manifest update

1 answer

Your answer