get:
  summary: Get user title
  operationId: getUserTitle
  parameters:
  - in: path
    name: user_id
    required: true
    schema:
      type: integer
      format: int64
  - in: path
    name: title_id
    required: true
    schema:
      type: integer
      format: int64
  responses:
    '200':
      description: User titles
      content:
        application/json:
          schema:
            $ref: '../schemas/UserTitleMini.yaml'
    '204':
      description: No user title found
    '400':
      description: Request params are not correct
    '404':
      description: User or title not found
    '500':
      description: Unknown server error

patch:
  summary: Update a usertitle
  description: User updating title list of watched
  operationId: updateUserTitle
  parameters:
  - in: path
    name: user_id
    required: true
    schema:
      type: integer
      format: int64
  - in: path
    name: title_id
    required: true
    schema:
      type: integer
      format: int64
  requestBody:
    required: true
    content:
      application/json:
        schema:
          type: object
          properties:
            status:
              $ref: '../schemas/enums/UserTitleStatus.yaml'
            rate:
              type: integer
              format: int32
  responses:
    '200':
      description: Title successfully updated
      content:
        application/json:
          schema:
            $ref: '../schemas/UserTitleMini.yaml'
    '400':
      description: Invalid request body (missing fields, invalid types, etc.)
    '401':
      description: Unauthorized — missing or invalid auth token
    '403':
      description: Forbidden — user not allowed to update title
    '404':
      description: User or Title not found
    '500':
      description: Internal server error

delete:
  summary: Delete a usertitle
  description: User deleting title from list of watched
  operationId: deleteUserTitle
  parameters:
  - in: path
    name: user_id
    required: true
    schema:
      type: integer
      format: int64
  - in: path
    name: title_id
    required: true
    schema:
      type: integer
      format: int64
  responses:
    '200':
      description: Title successfully deleted
    '401':
      description: Unauthorized — missing or invalid auth token
    '403':
      description: Forbidden — user not allowed to delete title
    '404':
      description: User or Title not found
    '500':
      description: Internal server error