sometimes api docs lie