Add a bus

POST

https://ssuccessv2.com/app/api/v1/bussing/bus/create

POST

/app/api/v1/bussing/bus/create

$ curl -X POST https://ssuccessv2.com/app/api/v1/bussing/bus/create \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "name": "Bluebird 12",
>   "color": "Navy",
>   "bus_number": "BUS-012",
>   "vin_number": "1BAKGCPH0KF123456",
>   "capacity": 72,
>   "tracking_device_id": 8
> }'

1 {
2   "status": "success",
3   "message": "Saved successfully",
4   "data": {
5     "id": 12,
6     "name": "Bluebird 12",
7     "color": "Navy",
8     "bus_number": "BUS-012",
9     "vin_number": "1BAKGCPH0KF123456",
10     "capacity": 72,
11     "tracking_device_id": 8,
12     "device_status": "online",
13     "device_status_message": "Tracking normally",
14     "maintenance_schedules": [],
15     "device": null
16   }
17 }

Creates a bus in the active school. A tracking device, when supplied, must exist in that school and not already be assigned to another bus.

Authentication

AuthorizationBearer

The signed-in SchoolSet user token sent by the frontend.

Request

This endpoint expects an object.

namestringRequired<=255 characters

colorstring or nullOptional

bus_numberstring or nullOptional

vin_numberstring or nullOptional

capacityinteger or nullOptional0-1000

tracking_device_idinteger or nullOptional>=1

Response

Bus created.

statusstringOptional

messagestringOptional

dataobjectOptional

Errors

401

Unauthorized Error

403

Forbidden Error

422

Unprocessable Entity Error