nyanimedb/api/paths/users-id-titles.yaml

get:
  summary: Get user titles
  parameters:
  - $ref: '../parameters/cursor.yaml'
  - $ref: "../parameters/title_sort.yaml"
  - in: path
    name: user_id
    required: true
    schema:
      type: string
  - in: query
    name: sort_forward
    schema:
      type: boolean
      default: true
  - in: query
    name: word
    schema:
      type: string
  - in: query
    name: status
    schema:
      type: array
      items:
        $ref: '../schemas/enums/TitleStatus.yaml'
    description: List of title statuses to filter
    style: form
    explode: false
  - in: query
    name: watch_status
    schema:
      type: array
      items:
        $ref: '../schemas/enums/UserTitleStatus.yaml'
    style: form
    explode: false
  - in: query
    name: rating
    schema:
      type: number
      format: double
  - in: query
    name: my_rate
    schema:
      type: integer
      format: int32
  - in: query
    name: release_year
    schema:
      type: integer
      format: int32
  - in: query
    name: release_season
    schema:
      $ref: '../schemas/enums/ReleaseSeason.yaml'
  - in: query
    name: limit
    schema:
      type: integer
      format: int32
      default: 10
  - in: query
    name: fields
    schema:
      type: string
      default: all
  responses:
    '200':
      description: List of user titles
      content:
        application/json:
          schema:
            type: object
            properties:
              data:
                type: array
                items:
                  $ref: '../schemas/UserTitle.yaml'
              cursor:
                $ref: '../schemas/CursorObj.yaml'
            required:
            - data
            - cursor
    '204':
      description: No titles found
    '400':
      description: Request params are not correct
    '404':
      description: User not found
    '500':
      description: Unknown server error

post:
  summary: Add a title to a user
  description: User adding title to list af watched, status required
  operationId: addUserTitle
  parameters:
    - name: user_id
      in: path
      required: true
      schema:
        type: integer
        format: int64
      description: ID of the user to assign the title to
      example: 123
  requestBody:
    required: true
    content:
      application/json:
        schema:
          type: object
          required:
            - title_id
            - status
          properties:
            title_id:
              type: integer
              format: int64
            status:
              $ref: '../schemas/enums/UserTitleStatus.yaml'
            rate:
              type: integer
              format: int32
  responses:
    '200':
      description: Title successfully added to user
      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 assign titles to this user
    '404':
      description: User or Title not found
    '409':
      description: Conflict — title already assigned to user (if applicable)
    '500':
      description: Internal server error

patch:
  summary: Update a usertitle
  description: User updating title list of watched
  operationId: updateUserTitle
  parameters:
    - name: user_id
      in: path
      required: true
      schema:
        type: integer
        format: int64
      description: ID of the user to assign the title to
      example: 123
  requestBody:
    required: true
    content:
      application/json:
        schema:
          type: object
          required:
            - title_id
          properties:
            title_id:
              type: integer
              format: int64
            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:
    - name: user_id
      in: path
      required: true
      schema:
        type: integer
        format: int64
      description: ID of the user to assign the title to
      example: 123

  responses:
    '200':
      description: Title successfully deleted
    # '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 delete title
    '404':
      description: User or Title not found
    '500':
      description: Internal server error