Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 7 Next »

3.12.0 3.20.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. 

Resource URL Summary

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}

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

API Specific Parameters

ParameterDescription

${UserID}

Identifies the REST Object Definitions User Related Objects User Object.

HTTP Headers

This API uses the default ServiceMobility HTTP Headers.

 


API Specifics

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

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. 

JSON Format
 {
	"Activated": true,
	"AuthenticationID": "",
	"Deleted": false,
	"DGroupID": "",
	"Email": "",
    "EnableMobileDiagnostics": false,
	"Extensions": {
		"key1": "value1",
		"key2": "value2"
	},
	"FaceTime": "",
	"FirstName": "",
	"IsMobileWorker": true,
	"LanguageCode": "",
	"LastName": "",
	"Locked": false,
	"Password": "",
	"Phones": [{
		"PhoneNum": "",
		"PhoneType": ""
	}],
	"ResetPassword": false,
	"ServiceTeamID": "",
	"SMS": "",
	"Status": "",
	"StorageLocationID": "",
	"UserID": ""
}

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

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

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.

Delete a specific User

URL

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.

Reset a User's Password

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

URL

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.

Change a User's Password

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

URL

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

HTTP Request Body

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

JSON Body Format
{
	"Password" : ""
}

HTTP Response

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

Assign Service Teams to a User

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

URL

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

HTTP Request Body

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

JSON Body Format
{
	"ServiceTeams": [
		// Service Teams ID
	]
}

HTTP Response

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

  • No labels