/trades Permission level: 5

post/trades

Request

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

Request body application/x-www-form-urlencoded

tradewithstring required

Array of employees ids (eg. "234,563,770")

reasonstring required
shiftinteger required

Response

200

statusinteger
errorunknown

Example response

{
  "status": 1,
  "data": {
    "id": 1145258,
    "user": {
      "id": "2",
      "name": "Ryan Fyfe"
    },
    "shift": {
      "id": "375872721",
      "created": "1485507472",
      "published": "0",
      "edited": "1485507472",
      "deleted": "0",
      "schedule": "66515",
      "type": "0",
      "needed": "0",
      "working": "1",
      "user": "2",
      "start_date": {
        "id": 2830,
        "month": 1,
        "day": 27,
        "wday": 5,
        "year": 2017,
        "weekday": "Fri",
        "mname": "Jan",
        "week": 4,
        "dayid": 6,
        "timeid": 37,
        "timeid_exact": 37,
        "formatted": "Jan 27, 2017",
        "iso8601": "2017-01-27T09:00:00-0500",
        "time": "09:00",
        "timestamp": 1485525600,
        "hours": 9,
        "date": "2017-01-27 09:00:00",
        "day_of_year": "26",
        "week_adjusted": 4,
        "sp_wday": 6
      },
      "end_date": {
        "id": 2830,
        "month": 1,
        "day": 27,
        "wday": 5,
        "year": 2017,
        "weekday": "Fri",
        "mname": "Jan",
        "week": 4,
        "dayid": 6,
        "timeid": 69,
        "timeid_exact": 69,
        "formatted": "Jan 27, 2017",
        "iso8601": "2017-01-27T17:00:00-0500",
        "time": "17:00",
        "timestamp": 1485554400,
        "hours": 17,
        "date": "2017-01-27 17:00:00",
        "day_of_year": "26",
        "week_adjusted": 4,
        "sp_wday": 6
      },
      "length": 8,
      "location": "0",
      "confirmed": "0",
      "ref": "0",
      "start_timestamp": "2017-01-27 09:00:00",
      "end_timestamp": "2017-01-27 17:00:00",
      "perms": "2",
      "paidtime": 8,
      "start_time": {
        "id": 37,
        "time": "09:00"
      },
      "end_time": {
        "id": 69,
        "time": "17:00"
      },
      "schedule_name": "BOD",
      "schedule_color": 1,
      "employees": [
        {
          "id": "2",
          "name": "Ryan Fyfe",
          "avatar": "1346472359",
          "status": "1",
          "last_active": "1485507584",
          "ratecard": "0",
          "present": "0"
        }
      ],
      "cost": {
        "staff": 1,
        "hours": 8
      },
      "repeats": "0",
      "trades": [
        {
          "trade_id": "1145258",
          "id": "2",
          "name": "Ryan Fyfe"
        }
      ]
    },
    "reason": "need day off",
    "date": 1485507584,
    "confirm_before": 1,
    "receivers": [
      {
        "user": {
          "id": "2500853",
          "name": "Rob Llewellyn"
        }
      }
    ]
  }
}

Changes