×

Create task

This API allows you to create a new task with assigned drivers, vehicles, addresses, times, and other parameters.

Creating via POST

Request address

To get the data, use the address: https://tasks.<server_address>/backend/public/dashboard/tasks
All parameters are sent in the request body.

Creating via GET

Request address

To get the data, use the address: https://tasks.<server_address>/backend/public/dashboard/tasks/set
All parameters are sent as query parameters.

Request parameters

  • c_task_type_id — task type ID
  • c_driver_id — array of driver IDs (optional)
  • c_vehicle_id — array of vehicle IDs (optional)
  • driver_phone — driver phone number (optional)
  • c_initiator_type — initiator type (task template)
  • c_begin_time — task start time (timestamp)
  • c_return_time — task end time (timestamp)
  • phone — initiator phone number (optional)
  • office — initiator office/apartment (optional)
  • description — task description (optional)
  • c_initiator — initiator name or full name
  • c_address_base — base address
  • c_address_base_lat — base latitude
  • c_address_base_lng — base longitude
  • c_address_tasks — task address
  • c_address_tasks_lat — task latitude
  • c_address_tasks_lng — task longitude
  • c_address_initiator — initiator address
    * — additional parameters defined in the task template (optional)
Additional for GET requests:
  • usr_id — user ID (from authorization)
  • acc_id — account ID (from authorization)
 

Example POST request

fetch("https://tasks.<server_address>/backend/public/dashboard/tasks", {
  method: "POST",
  headers: {
    "content-type": "application/x-www-form-urlencoded; charset=UTF-8",
    "x-csrf-token": token  // token obtained via getToken
  },
  body: "c_task_type_id=173&c_initiator_type=182&c_initiator=Test&c_driver_id=317&c_vehicle_id=fgr5b7e657rtg&c_address_base=..."
});
Response
{
  "success": true,
  "msg": "Task created"
}
  • success— true if the task was successfully created
  • msg— server message