Create a new bulk upsert job

post

https://{tenant}{.kallidus-suite.com}/api/v4/suite/users/bulk

Start a new asynchronous job to add or update users in bulk.

Body Params

A batch of user upsert records to be processed asynchronously. Each item follows the
same schema as the single-user POST /v4/suite/users request.

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

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

Language

Credentials

Bearer

URL

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

application/problem+json

202Bulk upsert job accepted for asynchronous processing

400Bad Request

401Unauthorized - Authentication required

403Forbidden - Insufficient permissions

500Internal Server Error