teams app manifest update
Update a Teams app manifest with path-based mutations
Usage​
teams app manifest update [appId] [options]
Arguments​
| Argument | Description | Required |
|---|---|---|
appId | Teams app ID (prompted if not provided) | No |
Options​
| Flag | Description |
|---|---|
--set-json <path=json> | [OPTIONAL] Set a manifest field using parsed JSON |
--remove <path> | [OPTIONAL] Remove a manifest field or array item |
--dry-run | [OPTIONAL] Preview changes without uploading |
--json | [OPTIONAL] Output as JSON |
Details​
Updates the remote app manifest directly by downloading the current package, applying path-based changes, validating the result against the Teams manifest schema, and uploading the updated package while preserving icons.
Schema validation uses the manifest $schema URL when present, or derives the schema URL from manifestVersion. Schemas are cached locally after the first fetch.
By default, the command shows a summary of added, updated, and removed values and asks for approval before upload. Use global --yes to skip the prompt. Use --dry-run to preview changes without uploading.
--set-json parses values with JSON.parse(), so strings must be quoted as JSON strings.
Examples​
Set a string field:
teams app manifest update <appId> --set-json 'name.short="Contoso Bot"'
Set an array field:
teams app manifest update <appId> --set-json validDomains='["contoso.com"]'
Remove an object field:
teams app manifest update <appId> --remove webApplicationInfo
Remove an array item by index:
teams app manifest update <appId> --remove validDomains[0]
Preview without upload:
teams app manifest update <appId> --set-json 'name.short="Preview"' --dry-run