Enhanced Access Administration API: Update user

Purpose - Update a user.

URL - Select the URL for your location:

• https://frontdoor.apptio.com/api/user/
• https://frontdoor-eu.apptio.com/api/user/
• https://frontdoor-au.apptio.com/api/user
• https://frontdoor-usgov.apptio.com/api/user
• https://frontdoor-aug.apptio.com/api/user

Method - PUT

JSON parameters:

The user object must contain either the login or the universally unique identifier (UUID) of the user.

Headers - Pass apptio-opentoken header received as a response from the authentication call. See Basic authentication using user name and password.

Constraints:

• ID or login for the user account must map to an existing user account.
• Email of the user must be a valid email address.

Required permissions:

• Caller must have permissions to update users in the authentication domain specified.
  • If the user is in the same authentication domain as the caller, then the caller must have the manageUser permission in any environment in that authentication domain.
  • If the user is in an authentication domain that is different from the caller's authentication domain, then the caller must have the manageDomainUsers permission in the environment of that authentication domain.
• The logged-in user can update their email or full name.

PUT /api/user HTTP/1.1
Host: frontdoor.apptio.com
Content-Type: application/json
Apptio-opentoken: *****************************************************************************************
{
"login": "foo@acme.com",
"email": "footest@acme.com",
"full": "Test User"
}

Return codes:

{
	"id": "<string>",
	"login": "<string>",
	"active": <true/false>,
	"full": "<string>",
	"email": "<string>",
	"persona": {
		"enumValue": "APPLICATION_PLATFORM_OWNER"
  	},
	"forcePwdChange": <true/false>,
	"domain": "<string>",
	"failedLoginCount": <int>,
	"createdBy": "<string>",
	"updatedBy": "<string>",
	"accountType": "STANDARD",
	"external": <true/false>,
	"accountStatus": "<string>"
}