When a company is registered it not only creates a company but also a user. This user is a special “owner” user that cannot be deleted and is also automatically designated as part of the admin permission group.
Outside of the “owner” users, Rehive supports the creation/registration of users under specific groups (roles) and permissions. Users have several optional unique identifiers:
- id
- username
- mobile
These identifier may not be shared by any other users in the company*.
Object
Users have a multitude of attributes and properties that can be used to store identity information as well as settings and state. The full user object looks like this:
{
"id": "00000000-0000-0000-0000-000000000000",
"first_name": "Joe",
"last_name": "Soap",
"email": "[email protected]",
"username": null,
"id_number": "",
"birth_date": "2000-01-01",
"profile": null,
"company": "rehive",
"currency": {
"description": "Rand",
"code": "ZAR",
"symbol": "R",
"unit": "rand",
"divisibility": 2
},
"account": "0000000000",
"balance": 0,
"available_balance": 0,
"language": "en",
"nationality": "ZA",
"website": null,
"metadata": null,
"mobile": "+27840000000",
"timezone": "Asia/Dhaka",
"verified": true,
"verification": {
"email": true,
"mobile": true
},
"status": "pending",
"groups": [
{
"name": "user",
"label": "User"
}
],
"created": 1464912953000,
"updated": 1464912953000,
"settings": {
"allow_transactions": true,
"allow_debit_transactions": true,
"allow_credit_transactions": true,
"disallowed_transaction_subtypes": []
},
"deactivated": false,
"last_login": 1464912953000,
"archived": false,
"temporary": false
}
Endpoints
Take a look at the Platform API Reference for the list of user endpoints.
Take a look at the Platform Admin API Reference for the list of user management endpoints.
Usage
Usage remains the same for all endpoints in Rehive. Simply invoke one of the allowed HTTP methods with the correct Content-Type and an Authorization header.