How do you usually structure API request examples to keep docs more developer friendly?

Hi everyone,
I wanted to ask a general question regarding best practices in API documentation.

When you are writing docs or guides, do you feel it is better to show very short minimal request examples, or do you prefer showing complete real-world example requests that include optional parameters, error responses, headers etc?

I’ve seen different styles — some platforms keep everything extremely short and simple, while others show full real usage blocks. I’m trying to understand what developers generally find more helpful and what reduces confusion for beginners.

What format do you personally find easier to learn from?
Minimal examples or full practical request/response blocks?

Would love to hear opinions from developers who work with APIs regularly.

Thanks!