From a user:

"Although it would be nice to return the final bson structure (maybe optionally, when a ptr** is not null) as an additional argument to the client to avoid a separate query to obtain it. If the argument is NULL, gridfs_insert_file() could bson_destroy ret, otherwise the client has to do it."