Page MenuHomePhabricator

Contributor deletes a page slot
Open, Needs TriagePublic

Description

"As a Contributor, I want to delete a page slot, because the information in that slot no longer applies to the page."

DELETE /page/{title}/slot/{role}

Deletes the slot in the role role for the page title.

Request body: none

Notable request headers: none

Status codes:

  • 200: the slot was deleted; request body is placeholder content
  • 401: deleting this slot requires authentication and the user is unauthenticated
  • 403: the authenticated user is forbidden from deleting the slot
  • 404: there is no such page or no such slot

Notable response headers: none

Response body: JSON object, one property

  • status: fixed string, "OK".

Event Timeline

I prefer having placeholder content for delete endpoints and using 200 codes, rather than 202 or 204. Client developers just like getting 200, and they don't want to have to figure out the other codes.