type: object
properties:
  avatar_id:
    type: integer
    format: int64
    nullable: true
    description: ID of the user avatar (references `images.id`); set to `null` to remove avatar
    example: 42
  mail:
    type: string
    format: email
    pattern: '^[a-zA-Z0-9._-]+@[a-zA-Z0-9._-]+\\.[a-zA-Z0-9_-]+$'
    description: User email (must be unique and valid)
    example: john.doe.updated@example.com
  disp_name:
    type: string
    description: Display name
    maxLength: 32
    example: John Smith
  user_desc:
    type: string
    description: User description / bio
    maxLength: 512
    example: Just a curious developer.
additionalProperties: false
description: Only provided fields are updated. Omitted fields remain unchanged.