Add examples and improve validation

[yamcodes]

Clear and concise description of the problem

Validation and dto can be improved by adding examples.

Suggested solution

Apply examples and richer validation à la https://github.com/bedtime-coders/bedstack-stripped

Alternative

No response

Additional context

No response

Validations

• Read the Contributing Guide.
• Read the README.md.
• Check that there isn't already an issue that requests the same feature.