User to Position

This feed works with the Performance system and allows you to map employees/users to a position within the organization. This leads to employees/managers being set-up for Performance Appraisal cycles using data gathered in another system.


Model Schema

{
  "positionUserId": "",
  "position": {
    "id": "",
    "reference": "39151"
  },
  "user": {
    "id": "",
    "reference": "37932"
  },
  "positionUserType": "Actual",
  "positionUserStatus": "Commenced",
  "startDate": "2026-01-20",
  "endDate": "2026-03-30",
  "probationEndDate": "2026-02-28",
  "salary": "$108591 omnis officiis ducimus culpa ullam",
  "isDeleted": true
}

 

Parameters

GET /PositionUsers/
Parameter Description Parameter Type Data Type
positionReference Filter by Position Reference (exact match) query string
userReference Filter by User Reference (exact match) query string
salary Filter by Salary keywords query string
startDateAfter Filter by the start dates after provided date; ISO-8861. query string
startDateBefore Filter by the start dates before provided date; ISO-8861. query string
endDateAfter Filter by the end dates after provided date; ISO-8861. query string
endDateBefore Filter by the end dates before provided date; ISO-8861. query string
probationEndDateAfter Filter by the probation end dates after provided date; ISO-8861. query string
probationEndDateBefore Filter by the probation end dates before provided date; ISO-8861. query string
positionUserStatus Filter by user status (exact match) query string
positionUserType Filter by user type (exact match) query string
isDeleted Filter by Is Deleted (true or false) query boolean
sort Field(s) to sort by, prefix with ‘-‘ for reverse; userReference (asc) / -userReference(desc). query string
recordsPerPage Maximum number of results to return. The absolute maximum for this value is 1,000. A value over 1,000 will result in the value being set to 1,000. query integer
pageNumber Page to start on, related to the recordsPerPage parameter query integer

 

POST /PositionUsers/
PositionUser PositionUser object body See Model Schema
PUT /PositonUsers/
PositionUser PositionUser object body See Model Schema
GET /PositionUsers/{positionUserId}/
positionUserId The positionUserId of the position user mapping to get path string

 

PUT /PositionUsers/{positionUserId}/
PositionUser PositionUser object body See Model Schema