teams app update

Update a Teams app's properties

Usage

teams app update [appId] [options]

Arguments

Argument	Description	Required
appId	App ID	No

Options

Flag	Description
--endpoint <url>	[OPTIONAL] Set the bot messaging endpoint URL
--name <name>	[OPTIONAL] Set the app short name (max 30 chars)
--long-name <name>	[OPTIONAL] Set the app long name (max 100 chars)
--short-description <desc>	[OPTIONAL] Set the short description (max 80 chars)
--long-description <desc>	[OPTIONAL] Set the long description (max 4000 chars)
--developer <name>	[OPTIONAL] Set the developer name
--website <url>	[OPTIONAL] Set the website URL (HTTPS required)
--privacy-url <url>	[OPTIONAL] Set the privacy policy URL (HTTPS required)
--terms-url <url>	[OPTIONAL] Set the terms of use URL (HTTPS required)
--color-icon <path>	[OPTIONAL] Set the color icon (192x192 PNG)
--outline-icon <path>	[OPTIONAL] Set the outline icon (32x32 PNG)
--json	[OPTIONAL] Output as JSON

Details

Updates app properties in both TDP and (for endpoint changes on Azure bots) via az CLI.

Interactive vs Scripted

• No flags, no appId — interactive mode: app picker, then an update menu for each property
• With flags — scripted mode: applies changes directly without prompts

Endpoint Updates

When you change the endpoint, teams also updates the validDomains array in the manifest to include the new endpoint's domain. For Azure bots, the endpoint is updated via az bot update.

Examples

Update the endpoint:

teams app update <appId> --endpoint https://mybot.azurewebsites.net/api/messages

Update multiple properties at once:

teams app update <appId> --name "New Name" --version "2.0.0" --developer "My Team"

Portal Equivalent

Apps → select app → Basic information in the Teams Developer Portal.