After talking it through with Nico and Martin we've decided to refactor the arguments for the navigation add method.
Internally the order of the arguments made sense, however for outward usability of the navigation API it makes sense to move argument 5 $action up to the second argument.