Skip to content

User

User management.

Find

Find matching users.

Endpoint

HTTP
POST /user/find

Authorized User Role

user

Request Body

FieldTypeRoleNotes
emailstringadminEmail address.
idstringadminUser ID.

Query String Options

FieldTypeDefaultNotes
indexstringIndex name: primary or gs1.
limitnumberLimit number of results.
nextobjectToken for next page.
prevobjectToken for previous page.

Response

Paged response.

FieldTypeNotes
dataarrayAn array of User records.
nextstringPaged cursor to use for the next page of items.
prevstringPages cursor to use for the previous page of items.

User

FieldTypeNotes
accountIdstringOwning account ID.
activitydateUser activity date.
emailstringUser email address.
firststringUser first name.
idstringUser ID.
invitestringInvite code.
laststringUser last name.
preferencesobjectUser preferences.
rolestringUser role.
statestringUser state.

Get

Get a user by ID.

Endpoint

HTTP
POST /user/get

Authorized User Role

user

Request Body

FieldTypeRoleNotes
emailstringadminEmail address.
idstringadminUser ID.

Response

User Record.

FieldTypeNotes
accountIdstringOwning account ID.
activitydateUser activity date.
emailstringUser email address.
firststringUser first name.
idstringUser ID.
invitestringInvite code.
laststringUser last name.
preferencesobjectUser preferences.
rolestringUser role.
statestringUser state.

Login

Login the authenticated user.

Endpoint

HTTP
POST /user/login

Authorized User Role

public

Request Body

FieldTypeNotes
invitestringInvite code.
registerbooleanRegister.

Response

A user object.

FieldTypeNotes
accountobjectAccount object.
userobjectUser object.

Remove

Remove a user.

Endpoint

HTTP
POST /user/remove

Authorized User Role

admin

Request Body

FieldTypeNotes
emailstringEmail address.
idstringUser ID.

Update

Update a user.

Endpoint

HTTP
POST /user/update

Authorized User Role

user

Request Body

FieldTypeNotes
emailstringEmail address.
firststringFirst name.
idstringUser ID.
laststringLast name.
preferencesobjectPreferences.

Response

User Record.

FieldTypeNotes
accountIdstringOwning account ID.
activitydateUser activity date.
emailstringUser email address.
firststringUser first name.
idstringUser ID.
invitestringInvite code.
laststringUser last name.
preferencesobjectUser preferences.
rolestringUser role.
statestringUser state.

UpdateRole

Update a user role.

Endpoint

HTTP
POST /user/updateRole

Authorized User Role

admin

Request Body

FieldTypeRoleNotes
idstringUser ID.
rolestringadminAuthorized role.
sendInvitebooleanSend invite email.

Response

User Record.

FieldTypeNotes
accountIdstringOwning account ID.
activitydateUser activity date.
emailstringUser email address.
firststringUser first name.
idstringUser ID.
invitestringInvite code.
laststringUser last name.
preferencesobjectUser preferences.
rolestringUser role.
statestringUser state.