"As a Contributor, I want to set the description of a page, so that readers will have context for what the page is about."
This is a uniform interface for setting the description of the page, whether the description is stored in wikibase or in a local property. The description is mapped to a sub-resource of the page.
If this wiki uses local descriptions, this method should either replace a call to the short description template if it already exists anywhere in the page content, or prepend a call to the short description template if it doesn't.
If this wiki uses Wikidata descriptions, it should write to Wikidata.
see T259622 for configuration options.
PUT /page/{title}/description
Set the description of the page. It will be created if it does not already exist.
Notable request headers: none
Request body: JSON object with the following property
- description: string, new description of the page, no wikitext or HTML markup
Status:
- 200: OK, description was updated
- 403: Not allowed to update the description
- 404: No such page
Notable response headers: none
Response body: JSON object
- description: echo back the description that was sent