Page MenuHomePhabricator

Reading List REST Interface: PUT lists endpoint
Closed, ResolvedPublic

Description

NOTE: The deprecated "id" value from the response is not being used by any callers and can be removed in the new implementation

Create a REST handler and any other necessary associated code (extension.json entry, helper classes, etc.) for the PUT lists endpoint.

  • endpoint implemented
  • tests created
  • tests pass

Endpoint summary:
Update a list

Endpoint description:
List must belong to current user and request must be authenticated with a MediaWiki session cookie. If the name is changed, the new name must not be in use.
Stability: unstable

Associated RESTBase code
lists.yaml (spec+forwarding)
lists.js (tests)

Associated Action API code
ApiReadingListsUpdate
ApiReadingListsUpdateTest

Parameters:

namesourcerequiredtypeexampledefaultpossible valuesdescription
idpathyesinteger42N/AN/A
csrf_tokenqueryyesstringf63c343876da566045e6b59c4532450559c828d3+\\N/AN/AThe CRSF edit token provided by the MediaWiki API

Request Body:
list_write

Error Response

#/components/schemas/problem per API.md and draft-nottingham-http-problem

Success Response

valuetypedescription
idintegerList ID. Deprecated, will be removed. Use the full list object.
listobject: list_read

Response Headers

This endpoints has additional response headers specified in the RESTBase code:

headers:
  content-type: application/json; charset=utf-8

Event Timeline

Restricted Application added a subscriber: Aklapper. · View Herald Transcript
BPirkle renamed this task from Reading List REST Interface: create lists PUT endpoint to Reading List REST Interface: PUT lists endpoint.Nov 14 2023, 2:58 AM
BPirkle updated the task description. (Show Details)

Change 983241 had a related patch set uploaded (by BPirkle; author: BPirkle):

[mediawiki/extensions/ReadingLists@master] REST Handlers for managing reading lists

https://gerrit.wikimedia.org/r/983241

Change 983241 merged by jenkins-bot:

[mediawiki/extensions/ReadingLists@master] REST Handlers for managing reading lists

https://gerrit.wikimedia.org/r/983241

BPirkle updated the task description. (Show Details)