Status

colour	Green
title	3.12.0

Status

colour	Yellow
title	3.20.0

Status

colour	Yellow
title	3.40.0

Status

colour	Yellow
title	4.4.0

The User REST API is used to create, retrieve, update or delete User Objects. The User API also provides separate URLs for resetting and changing a user's password.

Panel

borderColor	grey
bgColor	whitesmoke

On this page:

Table of Contents

maxLevel	2

Related pages:

Resource URL Summary

Panel

borderColor	grey
bgColor	whitesmoke
borderStyle	solid

Retrieve the details of a specific User

GET /seiapi/v3/trans/User/${UserID}

Insert or Update the details of a specific User

PUT /seiapi/v3/trans/User/${UserID}?emailNotification=true

Delete a specific User

DELETE /seiapi/v3/trans/User/${UserID}

Reset a User's Password

PUT /seiapi/v3/trans/User/${UserID}/ResetPassword

Change a User's Password

PUT /seiapi/v3/trans/User/${UserID}/ChangePassword

Assign Service Teams to a User

PUT /seiapi/v3/trans/User/${UserID}/ServiceTeams

Retrieve the details of a specific User's Entity

GET /seiapi/v3/trans/User/${UserID}/Entity

Impersonate a specific User

POST /seiapi/v3/trans/User/${UserID}/impersonate

API Specific Parameters

Parameter	Description
`${UserID}`	Identifies the REST Object Definitions User Related Objects User Object.
`emailNotification=true`	Add this query string parameter with a value of `true` to email user name and password for a new user.

Include Page

	_Default HTTP Headers
	_Default HTTP Headers

API Specifics

Panel

borderColor	#D3D3D3

Retrieve the details of a specific User

This REST API will return a User with the specified ID. The User with the specified ID must already exist in the system.

URL

Panel

borderColor	grey
bgColor	whitesmoke
borderStyle	solid

GET /seiapi/v3/trans/User/${UserID}

HTTP Request Body

This request does not require a request body.

HTTP Response Body

On success, an HTTP response code of 200 will be returned, and the response body will contain a REST Object Definitions User Related Objects User Object . Otherwise, on error, the response body will contain a descriptive reason for the error.

Include Page

	_User Object Formats
	_User Object Formats

Panel

borderColor	#D3D3D3

Insert or Update the details of a specific User

This REST API will insert a new User with the specified ID into the system, if a User with the specified ID does not already exist in the system.

If, however, the User with the specified ID does already exist in the system, then this REST API will update (i.e. replace) the already existing User with the specified ID with the details of the User supplied in the HTTP Request Body.

URL

Panel

borderColor	grey
bgColor	whitesmoke
borderStyle	solid

PUT /seiapi/v3/trans/User/${UserID}?emailNotification=true

HTTP Request Body

The HTTP request body must contain a valid REST Object Definitions User Related Objects User Object.

HTTP Response

On success the API will return a response code of 200.

Panel

borderColor	#D3D3D3

Delete a specific User

URL

Panel

borderColor	grey
bgColor	whitesmoke
borderStyle	solid

DELETE /seiapi/v3/trans/User/${UserID}

HTTP Request Body

This request does not require a request body.

HTTP Response

On success an HTTP response code of 200 will be returned. The system will return HTTP response code 410 in case of non-existent REST Object Definitions User Related Objects User Object .

Panel

borderColor	#D3D3D3

Reset a User's Password

This REST API will automatically generate a new password and email it to the user.

URL

Panel
`PUT /seiapi/v3/trans/User/${UserID}/ResetPassword`

HTTP Request Body

This request does not require a request body.

HTTP Response

On success an HTTP response code of 200 will be returned.

Panel

borderColor	#D3D3D3

Change a User's Password

This REST API will change a user's password to the supplied value.

URL

Panel
`PUT /seiapi/v3/trans/User/${UserID}/ChangePassword`

HTTP Request Body

The HTTP Request Body request body must contain the following JSON, where the supplied value is the password that is to be set.

Code Block

language	js
title	JSON Body Format

{
	"Password" : ""
}

HTTP Response

On success an HTTP response code of 200 will be returned.

Panel

borderColor	#D3D3D3

Assign Service Teams to a User

This REST API will assign supplied Service Teams to a user.

URL

Panel
`PUT /seiapi/v3/trans/User/${UserID}/ServiceTeams`

HTTP Request Body

The HTTP Request Body request body must contain a collection of valid Service Teams.

Code Block

language	js
title	JSON Body Format

{
	"ServiceTeams": [
		// Service Teams ID
	]
}

HTTP Response

On success an HTTP response code of 200 will be returned.

Panel

borderColor	#D3D3D3

Retrieve the details of a specific User's Entity

This REST API will return the details of User's Entity from the system. The User with the specified ID must already exist in the system.

URL

Panel

borderColor	grey
bgColor	whitesmoke
borderStyle	solid

GET /seiapi/v3/trans/User/${UserID}/Entity

HTTP Request Body

This request does not require a request body.

HTTP Response Body

On success, an HTTP response code of 200 will be returned, and the response body will contain a User Entity Object. Otherwise, on error, the response body will contain a descriptive reason for the error.

Include Page

	_User Entity Object Formats
	_User Entity Object Formats

Panel

borderColor	#D3D3D3

Impersonate a specific User

This REST API will allow the ServicePower Hub admin user or a Super Admin to impersonate another User for testing/debugging purposes. The User with the specified ID must already exist in the system.

Note
As the details of the admin user or Super User account that will be impersonating another User are passed into this API in the HTTP Request Body, this API must be called without the standard `x-access-token` header.

URL

Panel

borderColor	grey
bgColor	whitesmoke
borderStyle	solid

POST /seiapi/v3/trans/User/${UserID}/impersonate

HTTP Request Body

The HTTP request body must contain a JSON object containing the details of the ServicePower Hub admin user or Super User that will be impersonating the specified user:

Code Block

language	js
title	JSON Body Format

{
	"UserID": "<admin or super admin user id>",
	"Password": "<admin or super admin user password>"
}

HTTP Response Body

On success, an HTTP response code of 200 will be returned, and the response body will be a JSON object containing a JWT which can then be used to authenticate API calls via the x-access-token header to impersonate the specified user:

Code Block

language	js
title	JSON Body Format

{
	"Token": ""
}

Otherwise, on error, the response body will contain a descriptive reason for the error.

Versions Compared

Old Version 14

New Version 15

Key

Resource URL Summary

API Specific Parameters

API Specifics

Retrieve the details of a specific User

URL

HTTP Request Body

HTTP Response Body

Insert or Update the details of a specific User

URL

HTTP Request Body

HTTP Response

Delete a specific User

URL

HTTP Request Body

HTTP Response

Reset a User's Password

URL

HTTP Request Body

HTTP Response

Change a User's Password

URL

HTTP Request Body

HTTP Response

Assign Service Teams to a User

URL

HTTP Request Body

HTTP Response

Retrieve the details of a specific User's Entity

URL

HTTP Request Body

HTTP Response Body

Impersonate a specific User

URL

HTTP Request Body

HTTP Response Body

Page Comparison

Versions Compared

Old Version 14

New Version 15

Key

Resource URL Summary

API Specific Parameters

API Specifics

Retrieve the details of a specific User

URL

HTTP Request Body

HTTP Response Body

Insert or Update the details of a specific User

URL

HTTP Request Body

HTTP Response

Delete a specific User

URL

HTTP Request Body

HTTP Response

Reset a User's Password

URL

HTTP Request Body

HTTP Response

Change a User's Password

URL

HTTP Request Body

HTTP Response

Assign Service Teams to a User

URL

HTTP Request Body

HTTP Response

Retrieve the details of a specific User's Entity

URL

HTTP Request Body

HTTP Response Body

Impersonate a specific User

URL

HTTP Request Body

HTTP Response Body