An employee can hold one or more positions, and optionally, payments and working time can be held against an employee position, rather than directly as an attribute of the employment record. This means that potentially, an employee can hold more than one position, with working time and payments being held separately for each position
Add or update an employment position
Add or update an employment position
SecuritybearerAuth
Request
Request Body schema: application/vnd.api+json
Employee position to be added or updated
object |
Responses
200
Employee Position Response
default
General Error
post/employeePositions
Request samples
- Payload
- curl
- C#
- Java
- PHP
application/vnd.api+json
{- "data": {
- "type": "employeePositions",
- "attributes": {
- "effectiveFromDate": "2001-11-17",
- "postTitle": "Office Manager"
}, - "relationships": {
- "employment": {
- "data": {
- "id": "906264f1-2dff-4f72-a10b-59918cf738d7",
- "type": "employments"
}
}, - "lineManager": {
- "data": {
- "id": "4b30b724-26e1-4fcb-90f0-92936523133c",
- "type": "employments"
}
}, - "organisationUnit": {
- "data": {
- "id": "285f0a36-9ff3-4399-a47a-80e9bce56921",
- "type": "organisationUnits"
}
}
}
}
}Response samples
- 200
- default
application/vnd.api+json
{- "data": {
- "id": "a0bc1ba8-063e-c1fd-3e8f-6b5951f33e03",
- "type": "employeePositions",
- "attributes": {
- "effectiveFromDate": "2001-11-17",
- "postTitle": "Office Manager"
}, - "relationships": {
- "employment": {
- "links": {
}
}, - "lineManager": {
- "links": {
- "data": {
- "type": "employments",
- "id": "322f1e59-573d-1d93-7c01-3b6303abe9be"
}
}
}, - "organisationUnit": {
- "links": {
}
}
},
}
}Get Employment Position by Employment ID
Get Employment Position by Employment ID
SecuritybearerAuth
Request
Responses
200
Employee Position Response
default
General Error
get/employeePositions/{id}
Request samples
- curl
- C#
- Java
- PHP
Response samples
- 200
- default
application/vnd.api+json
{- "data": {
- "id": "a0bc1ba8-063e-c1fd-3e8f-6b5951f33e03",
- "type": "employeePositions",
- "attributes": {
- "effectiveFromDate": "2001-11-17",
- "postTitle": "Office Manager"
}, - "relationships": {
- "employment": {
- "links": {
}
}, - "lineManager": {
- "links": {
- "data": {
- "type": "employments",
- "id": "322f1e59-573d-1d93-7c01-3b6303abe9be"
}
}
}, - "organisationUnit": {
- "links": {
}
}
},
}
}