Create user

Creates a user which is *not active and has no password assigned*. The URL to get the user details is provided as Location Header in the response. #### ACTIVATION Upon creation, the user account undergoes an activation process (see services below ) in which she receives an email with activation link. Following this link the user is asked to set the password and upon successful completion of this process, the account becomes active and operational. Provided fields: * `username` (String required) - has to be the email of this user * `name` (String required) * `organisation` (Object optional) - **may be provided** by regular user, but **is required** for master user. * `roles` (List of Objects optional) - List of one or more role Ids to be assigned at once. If missing, a default role is assigned #### Notes * Password is not provided. Separate calls provide password management. * When the organisation of the new user is not specified in the request, it is inherited from the user creating the account. A regular user is allowed to specify **only organisations which are direct children** of his/her own organisation, or his/her own organisation. * The status field is not user editable at account creation time - the default imposed by server is ACTIVATION_PENDING.

Authentication

AuthorizationBearer

An auth_token should be provided to authenticate a session.

To obtain an auth_token, see the /api/v1/authenticate POST request.

Request

This endpoint expects an object.
usernamestringRequired
namestringRequired
organisationobjectRequired
roleslist of objectsRequired

Response

Resource Created

Errors