/positions Permission level: 3

post/positions

Request

  • Base URL
    https://www.humanity.com/api/v2
  • Auth
    API key in query parameter access_token

Request body application/x-www-form-urlencoded

namestring required
activestring

enum [1, -1] -> -1: Inactive; 1: Active

start_timestring date

Start time

end_timestring date

End time

colorinteger

Color

locationinteger

Location id

visibleinteger

enum [0, 1]

Response

200

statusinteger
tokenstring

Example response

{
  "status": 1,
  "data": {
    "id": 1324481,
    "name": "Dishwasher",
    "start_time": {
      "id": 1,
      "time": "12 am"
    },
    "end_time": {
      "id": 97,
      "time": "midnight"
    },
    "color": 1,
    "ical": "https://www.humanity.shiftplanning.com/ical/-8bcb5fb6197445930ec0d7fc34cd5b3f.ics?1470147335000",
    "visible": 1,
    "notify": 1,
    "location": {
      "id": 542312,
      "name": "Dream Coffee Takeaway"
    }
  },
  "token": "xxxxxxx"
}

Changes