swagger: '2.0'
info:
    title: issue-28
securityDefinitions:
    basicAuth:
        type: basic
paths:
  '/groupMailboxes/{groupMailboxID}/categories':
    parameters:
      - name: groupMailboxID
        in: path
        description: The ID of the group mailbox.
        required: true
        type: integer
    put:
      description: >-
        Update the categories associated with a group mailbox. Categories are
        added and removed as required.
      consumes:
        - application/json
      tags:
        - Group mailboxes
        - Categories
      produces:
        - application/json
      security:
        - basicAuth: []
      parameters:
        - name: body
          in: body
          description: What the categories list for the group mailbox should be.
          required: true
          schema:
            type: object
            properties:
              categories:
                type: array
                description: The category IDs.
                items:
                  type: integer
    post:
      description: >-
        Update the categories associated with a group mailbox. Categories are
        added and removed as required.
      consumes:
        - application/json
      tags:
        - Group mailboxes
        - Categories
      produces:
        - application/json
      security:
        - basicAuth: []
      parameters:
        - name: body
          in: body
          description: What the categories list for the group mailbox should be.
          required: true
          schema:
            type: object
            properties:
              categories:
                type: array
                description: The category IDs.
                items:
                  type: integer