You are viewing the Resources for the older version of JourneyApps (V3). JourneyApps V4 is the new default for all new apps since July 1, 2016.

Managing Mobile Users

A mobile user's app is associated with an App Instance by means of an enrollment. The mobile user object type (e.g. user) returns additional data to facilitate this.

Parameters

To retrieve, create, update or delete mobile users, follow the instructions in these sections of the documentation for your mobile user object type (e.g. user):

Caution: Deleting the user will disable the user's application. This operation is irreversible.

Response

The response includes all data normally returned by the basic operations: Create, Update, etc.

Additionally, enrollment details for the user are returned under an enrollment field:

  • Whether the device has scanned the enrollment barcode and successfully enrolled
  • The URL to which the app must connect to enroll, which is typically encoded in a QR code.

Example

We retrieve an object of our mobile user object type (i.e. user):

The response objects have an enrollment field that shows the user's enrollment status in enrolled and the URL for their enrollment barcode in url:

Resetting a Mobile User's enrollment

A mobile user can be re-enrolled with this function and subsequently scanning the enrollment barcode with the app.

Relative URL HTTP Request Method
/api/v1/mobile-object-type/object-id/re_enroll.format POST
Note: Replace mobile-object-type with the type of object associated with the mobile user (typically user), and object-id with the ID of the specific object. Replace format with the response data format (json or xml), or leave it out.
Warning: The re_enroll action effectively disables the user's app, until the enrollment barcode is scanned on the app.

Parameters

This function does not take any parameters.

Response

The response includes a success boolean value.

Example

Next Section: 13. Oplog
Previous Section Next Section