fake-swagger.yml

paths:
  /comments:
    post:
      request:
        body:
          - Comment
      response:
        - Comment

  /comments/:comment_id/actions:
    post:
      request:
        body:
          - Action
      response:
        - Action

  /comments/:comment_id/status:
    post:
      request:
        body:
          - ModerationAction

  /queue:
    get:
      query:
        type: (pending/flagged/rejected) # pending: no status, flagged: flagged action + no status, rejected: rejected status
        limit: integer
        skip: integer

  /stream:
    get:
      query:
        asset_id: String
      response:
        type: Array
        items:
          - Item

  /settings:
    get:
    put:

definitions:
  Action:
    type: object
    properties:
      type:
        type: string
      user_id:
        type: string

  Actions:
    type: object
    properties:
      item_id:
        type: string
      item_type:
        type: string # comment, user...
      type:
        type: string # flagged, likes, upvotes...
      count:
        type: integer
      current_user:
        type: boolean

  Comment:
    type: object
    properties:
      id:
        type: string
      body:
        type: string
      created_at:
        type: datetime
      user_id:
        type: string
      parent_id:
        type: string
      asset_id:
        type: string