create or update a user, and conditionally commit the user's data

This "upsert" API synchronously processes a user's data and returns the processing report. If any error(s) occurs during the processing, the report will include error information and a BadRequest response will be returned.

This API can be exercised in dry-run mode by setting the commit query parameter as follows. If commit is false, user data will be validated but there is no persistence of the user data in Cogito services. If commit is true, user data will be validated and user objects will be persisted for users with no validation errors. By default, commit is true.

Processing may take a relatively long amount of time so the request's timeout should be set accordingly.