GET Positions
Changed on/positions Permission level: 7
get/positions
Request
- Base URLhttps://www.humanity.com/api/v2
- AuthAPI key in query parameter access_token
Query parameters
permsinteger
enum[1] -> 1: Show perms
updated_atstring date
DateTime in ISO8601 format. <br> Retrieves only positions that were updated <strong>after</strong> the date and time provided with this parameter.
include_deletedinteger
enum[0,1] -> 0: Do not Include deleted positions; 1: Include deleted positions. It has to be used in conjunction with 'updated_at' parameter.
Response
200
Example response
{
"status": 1,
"data": [
{
"id": 1321636,
"name": "Desk Service",
"start_time": {
"id": 1,
"time": "12 am"
},
"end_time": {
"id": 97,
"time": "midnight"
},
"color": 11,
"ical": "https://www.humanity.shiftplanning.com/ical/-89ec2cc0b3e7ef6e44095846bd6d2e8e.ics?1470147114000",
"visible": 1,
"notify": 1
}
],
"token": "xxxxxxx"
}Changes
- info
endpoint added
- info