For optional parameters, always state the default value. Ambiguity leads to bugs.
If you're building API docs and want to discuss or best practices for your API type (REST vs. GraphQL), Nancy N. - Technical Writer & SEO Content Specialist api docs