POST /users
Sections
Creates a new local user. You can add the new user to user
roles by specifying an array of roles in role_ids
. You can set a password for the user in password
. For the password to work in the PE console, it needs to
be a minimum of six characters. Authentication is required.
Request format
Accepts a JSON body containing entries for
email
, display_name
, login
, role_ids
, and password
. The password field is optional. The created account is not
useful until the password is set.
For example:
{"login":"Kalo",
"email":"kalohill@example.com",
"display_name":"Kalo Hill",
"role_ids": [1,2,3],
"password": "yabbadabba"}
Copied!
Response format
If the create operation is successful, a 201 Created response with a location header that points to the new resource is returned.
Error responses
If the email or login for the user conflicts with an existing user's login, a 409 Conflict response is returned.