Document REST API changes

[BenLubar]

Here's what I've been able to gather:

• new OAuth2 scopes:
  • read:bookmarks
  • write:bookmarks
• new endpoints:
  • GET /api/v1/bookmarks
  • POST /api/v1/statuses/:id/bookmark
  • POST /api/v1/statuses/:id/unbookmark
  • GET /api/v1/timelines/direct
  • GET /api/v1/mutes/details
  • DELETE /api/v1/notifications/:id
  • DELETE /api/v1/notifications/destroy_multiple?ids[]=...
• changes:
  • Account: followers_count can be -1 if counts are hidden
  • Instance: add fields:
    • max_toot_chars (number) (would be nice to get the other max_* env variables here)
    • poll_limits (object)
  • List: add field:
    • replies_policy (string)
  • Status: add optional fields:
    • bookmarked (boolean)
    • local_only (boolean)
    • content_type (string)

[Gargron]

DELETE /api/v1/notifications/:id

This is what POST /api/v1/notifications/:id/dismiss does in upstream.

[ClearlyClaire]

Yeah, this is an alias