Create a bus run setup

POST

https://ssuccessv2.com/app/api/v1/bussing/run-setup/create

POST

/app/api/v1/bussing/run-setup/create

$ curl -X POST https://ssuccessv2.com/app/api/v1/bussing/run-setup/create \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "academic_year_id": 2026,
>   "name": "Morning Route",
>   "start_time": "07:00:00",
>   "end_time": "08:15:00",
>   "time_type_id": 1,
>   "stop_type_id": 1,
>   "amount_of_routes": 4,
>   "class_ids": [
>     301,
>     302
>   ],
>   "grade_ids": [
>     7,
>     8
>   ],
>   "days_of_week": [
>     "Monday",
>     "Tuesday",
>     "Wednesday",
>     "Thursday",
>     "Friday"
>   ]
> }'

1 {
2   "status": "success",
3   "message": "Saved successfully.",
4   "data": {
5     "id": 12,
6     "name": "Morning Route",
7     "start_time": "07:00:00",
8     "end_time": "08:15:00",
9     "amount_of_routes": 4,
10     "school_grades": [],
11     "school_classes": [],
12     "days_of_week": [
13       "Monday",
14       "Tuesday",
15       "Wednesday",
16       "Thursday",
17       "Friday"
18     ]
19   }
20 }

Creates a scheduled bus run for an academic year, optionally limited to selected grades or classes.

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.

academic_year_idintegerRequired>=1

namestringRequired<=255 characters

start_timestringRequiredformat: "^([0-1]\\d|2[0-3]):[0-5]\\d:[0-5]\\d$"

end_timestringRequiredformat: "^([0-1]\\d|2[0-3]):[0-5]\\d:[0-5]\\d$"

time_type_idintegerRequired

stop_type_idintegerRequired

amount_of_routesintegerRequired1-100

class_idslist of integersOptional

grade_idslist of integersOptional

days_of_weeklist of enumsOptional

Response

Run setup created.

statusstringOptional

messagestringOptional

datamap from strings to anyOptional

Errors

401

Unauthorized Error

403

Forbidden Error

422

Unprocessable Entity Error