How to add custom properties to requestBody?

[zorca]

I'm trying to add a required: true parameter for the entire requestBody object, but I don't understand how to do it using the extension. Maybe someone has an example?

[romalytvynenko]

@zorca I don't understand what exactly you want to achieve. Can you show the example of the expected OpenApi spec?

[zorca]

As you can see, requestBody contains the parameter "required": true

[zorca]

And working full example: https://app.swaggerhub.com/apis/STEELPUPPY_1/laravel/0.0.1#/Auth/auth.login

[manuel-watchenterprise]

@romalytvynenko +1

Being able to mark the full requestBody object as required is not only useful when documenting the API but code generators are using as well to mark a request call's param as optional or mandatory.

The current implementation of RequestBodyObject does not allow this even from custom extension.

class RequestBodyObject
{
    public bool $required = false;

    public function required(bool $required = true): self
    {
        $this->required = $required;

        return $this;
    }

    public function toArray(): array
    {
        $result = array_filter([
            'description' => $this->description,
            'required' => $this->required,
        ]);

        // ...

        return $result;
    }
}

[manuel-watchenterprise]

Thank you @romalytvynenko for this feature! 🚀
#580