fixed weird api behaviour
added note