Can the endpoint documentation be overwritten? about cooptilleulsforgotpasswordbundle HOT 3 CLOSED

public function __construct(private OpenApiFactoryInterface $decorated)
{
}

/**
 * @psalm-suppress PossiblyNullReference
 */
public function __invoke(array $context = []): OpenApi
{
    $openApi = ($this->decorated)($context);
    $schemas = $openApi->getComponents()->getSchemas();

    $schemas['ForgotPassword:reset'] = new \ArrayObject([
        'type' => 'object',
        'properties' => [
            'password' => [
                'type' => 'string',
                'example' => 'password',
            ],
            'confirm_password' => [
                'type' => 'string',
                'example' => 'password',
            ],
        ],
    ]);

    $pathItem = new Model\PathItem(
        ref: 'ForgotPassword',
        post: new Model\Operation(
            parameters: [new Model\Parameter(
                name: 'tokenValue',
                in: 'path',
                description: 'Token value',
                required: true,
            )],
            operationId: 'postForgotPasswordToken',
            tags: ['Forgot password'],
            responses: [
                204 => [
                    'description' => 'Email address format valid, no matter if user exists or not',
                 ],
                400 => [
                    'description' => 'Missing password parameter',
                ],
                404 => [
                    'description' => 'Token not found',
                ],
            ],
            summary: 'Validates token test',
            requestBody: new Model\RequestBody(
                description: 'Reset password',
                content: new \ArrayObject([
                    'application/json' => [
                        'schema' => [
                            '$ref' => '#/components/schemas/ForgotPassword:reset',
                        ],
                    ],
                ]),
            )
        )
    );
    $openApi->getPaths()->addPath('/api/users/password-reset/{tokenValue}', $pathItem);

    return $openApi;
}