Fimfiction Developers

Scopes

Scopes act as permissions for various part of the API. They can be requested as part of the authorisation process for a user and upgraded later with a similar request.

You should always aim to request as few scopes as possible. Users will be less likely to be apprehensive about using applications that request only a few scopes.


Scope List

  • write_blog_posts - Create, update and delete blog posts.
  • read_bookshelves - Read private bookshelves.
  • write_bookshelves - Create, update and delete bookshelves.
  • read_bookshelf_items - Read the items in private bookshelves.
  • write_bookshelf_items - Add / remove items from the user's bookshelves
  • read_pms - Read the user's PMs
  • write_pms - Send / delete the user's PMs
  • write_followers - Follow / unfollow users
  • read_stories - Read the user's unpublished stories.
  • write_stories - Create, update and delete stories.
  • write_comments - Create, update and delete comments.
  • read_user - Read private account information (just email currently).
  • write_user - Modify account information.
  • read_chapter_read - See what chapters the user has read.
  • write_chapter_read - Mark chapters as read / unread.