The various functions on mongoc_find_and_modify_opts_t don't say whether the update, sort, etc. documents need to survive until after the options structure is used/destroyed. Reading the code, they appear to copy. Please make that explicit in the documentation.