RoscoLive API v1.0

add a driver

PUT/driver

Add a new driver to a company.

Request

Body Params multipart/form-data

company_id

integer

required

ID of company

>= 0

Example:

12345

first_name

string

required

Driver first name

Example:

{% faker name.firstName %}

last_name

string

required

Driver last name

Example:

{% faker name.lastName %}

string

required

Email address of the driver

Example:

{% faker internet.exampleEmail %}

card_id

string

required

Driver ID card

>= 8 characters<= 8 characters

Example:

A1B2C3D4

Match pattern:

^[A-Fa-f0-9]+

group_id

integer

optional

ID of group driver will be assigned to

>= 0

Example:

12345

Request samples

Responses

Success(200)

Record Not Found(404)

HTTP Code: 200

Content Type : JSONapplication/json

meta

object

required

Request metadata object

code

integer

required

HTTP status code returned by server

response

object

required

Contains response data

card_id

string

required

Assigned card ID

>= 8 characters<= 8 characters

Match pattern:

^[A-Fa-f0-9]+

card_scan_ts

required

Timestamp of latest card scan with ID

company_id

integer

required

ID of company

creation_ts

string <date-time>

required

Timestamp of driver user creation

Example:

2024-01-01 12:31:42

device_id

required

Device ID of last device scanned into

string

required

Email address of the driver

first_name

string

required

First name of driver

group_id

required

ID of assigned group in company

group_name

required

Name of assigned group in company

integer

required

ID of driver record

last_name

string

required

Last name of driver

name

string

required

Full name of driver

parent_driver_id

null

deprecated

Unused, will be depreciated in a future version

photos

array[string]

required

Unused, will always return empty. Will be depreciated in a future version.

status

string

required

User database status

type

enum<string>

required

Type of driver ID method used by company

Allowed values:

manualcard_id

result

string

required

"OK" if request successful, otherwise "Failed"

{
  "meta": {
    "code": 200
  },
  "response": {
    "card_id": "a2b3c4d5",
    "card_scan_ts": null,
    "company_id": 2,
    "creation_ts": "2024-08-09 18:17:37",
    "device_id": null,
    "email": "Jeanette.Christiansen@example.org",
    "first_name": "Makayla",
    "group_id": null,
    "group_name": null,
    "id": 2842,
    "last_name": "Goldner",
    "name": "Makayla Goldner",
    "parent_driver_id": null,
    "photos": [],
    "status": "used",
    "type": "manual"
  },
  "result": "OK"
}

Last modified: 5 months ago