The User API allows you to create, update, and remove user accounts. This API should only be called to manage users in the native security realm. Users from other security realms are managed directly by Fusion’s auth proxy.

​
Create, Update, Delete or List Users

The path for this request is: /api/users/<id> where <id> is the user ID.
In order to see this object within the Fusion UI, it must be associated with an app. To do this, create the object using the /apps endpoint.
A GET request lists information about the user. The ID can be omitted in a GET request to get all users. A POST request creates a new user, while a PUT updates a user record. DELETE will remove the user.

​
Input

ParameterDescription
username
Required		The username. This is distinct from their ID, which is assigned by the system as a unique identifier.
password
Required		The user’s password. Required when creating a new user. The user’s password is not returned in the output of any request.
passwordConfirm
Required		When creating a user or updating a user’s password, you must confirm the defined password.
realmName
Required		The realm the user belongs to, which defines how they authenticate against the system.
permissions
Optional		The permissions that have been defined for this user that are not inherited from their assigned role.
inheritedPermissions
Optional		The user’s specific permissions that are inherited from their role assignment.
roleNames
Optional		The list of user’s roles, which define some or all of the permissions they have.

​
Output

When creating a user with a POST request or listing users with GET, the user properties will be returned. When updating or removing a user with a PUT or DELETE, no output will be returned.

​
Examples

Get all the configured users of the system: REQUEST 
curl -u USERNAME:PASSWORD https://FUSION_HOST:8764/api/users
RESPONSE 
[
	{
	"realmName":"native",
	"username":"admin",
	"id":"2856ba33-80bd-400d-99dc-3d181bc68d9a",
	"roleNames":["admin"],
	"permissions":[],
	"createdAt":"2015-07-01T03:18:06Z"},
		{"realmName":"native",
		"username":"collection-admin",
		"id":"9780a33c-c49d-48e3-a869-bd65951aea8f",
		"roleNames":["ui-user","collection-admin"],
		"permissions":[],
		"createdAt":"2015-07-01T03:18:06Z"
	}
]
Add a new user named ‘guest’: REQUEST 
curl -u USERNAME:PASSWORD -X POST -H 'Content-type: application/json' -d '{"username":"guest", "password":"password456", "passwordConfirm":"password456", "realmName": "native"}' https://FUSION_HOST:8764/api/users
RESPONSE 
{
	"realmName":"native",
	"username":"guest",
	"id":"2f5b52a7-550d-407d-b592-32ab42afe3ca",
	"roleNames":[],
	"permissions":[],
	"createdAt":"2015-08-06T11:42:15Z"
}
Update a user to include the role named “admin”: REQUEST 
curl -u USERNAME:PASSWORD -X PUT -H 'Content-type: application/json' -d '{"name":"joe.smith", "realmName":"myLDAP", "roleNames":["admin"]}' https://FUSION_HOST:8764/api/users/aefa7ffc-23f1-45ac-b326-f7bb007d3b9d
RESPONSE None.