Update the Store listing
update_listingSaves changes to the Store listing as a draft; nothing goes to Microsoft until send_listing_update or the next submit_update. Pass languages as { "en-us": { "description": "..." } } with only the fields to change: title (a name reserved in Partner Center), shortDescription (up to 1000, about 270 shown), description (up to 10,000), features (up to 20 of 200, no bullets), keywords (search terms, up to 7 of 40 and 21 words in total). Lists replace the whole list; a field set back to its live text stops being a change. addLanguages adds Store languages (they need a description and get a copy of the English screenshots; translate_listing_missing fills their text and captions), removeLanguages removes languages added in the draft. certNotes replaces the notes for certification, which go out with every submission. Returns the listing overview with its problems.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"appId": "<appId>"
},
"name": "update_listing"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| appId | Yes | The app id from list_apps. | |
| certNotes | No | Notes for certification for Microsoft's testers. An empty string clears them. | |
| languages | No | Fields to change per language code. | |
| addLanguages | No | Store language codes to add, like fr-fr or ja. | |
| removeLanguages | No | Languages added in the draft to take out again. |