Replace a user

put

https://{tenant}{.kallidus-suite.com}/api/v4/suite/users({userIdentifier})

Replace all details for an existing user. Any fields not provided are cleared.

Path Params

userIdentifier

string

required

The user's ID (guid) (e.g., b48737b7-62ac-421b-9c12-3c1014dd07b7)

Body Params

Create or replace user payload. If both startDate and leaveDate are provided, startDate must be earlier than leaveDate.

username

string

required

length between 1 and 100

^\S+$

givenName

string

required

length between 1 and 50

familyName

string

required

length between 1 and 50

preferredName

string

dateOfBirth

date

Date of birth in YYYY-MM-DD format

emailAddress

string

length ≤ 256

ccEmailAddress

string

length ≤ 256

mobileNumber

string

culture

string

enum

department

string

division

string

companyName

string

managerType

string

preferredTrainingLocation

string

location

string

region

string

roles

object

costCenter

string

payGrade

string

payrollNumber

string

contractType

string

employeeCategory

string

isEnabled

boolean

required

startDate

date

Start date of employment in YYYY-MM-DD format

leaveDate

date

End date of employment in YYYY-MM-DD format

isAbsent

boolean

isFireWarden

boolean

isFirstAider

boolean

importKey

string

required

length ≤ 256

brandId

uuid | null

The ID of the brand to assign to the user. Omit or set to null to use the system default.

primaryJobProfileId

uuid | null

The ID of the primary job profile to assign to the user. Omit or set to null to leave the user with no primary job profile.

primaryGroupId

uuid | null

The ID of the group to set as the user's primary group. Omit or set to null to leave unset.

additionalJobProfileIds

array of uuids | null

The IDs of the user's job profiles other than the primary. Replaces the collection entirely - any job profile not listed is unassigned. Omit it, or send null or an empty array, to leave the user with no additional job profiles. No ID may refer to the user's primary job profile, and no ID may appear more than once.

additionalJobProfileIds

userInformationFields

object

Responses

204

User replaced successfully

400Bad Request

401Unauthorized - Authentication required

403Forbidden - Insufficient permissions

404Not Found

409Conflict - One or more provided identifiers already belong to an existing user

500Internal Server Error