We should specify that this is optional, and that while it takes precedence over 'mode' you still need to specify the mode as well... and it must match the mode that is registered to that mimetype.  Which actually seems a little error-prone -- I wonder if there's a way we could get the mode from CM automatically so that people only have to specify the mimetype?