Upsert Driver Credential Ep

POST 
/v1/driver/credential/upsert_many

Upsert Many Driver Credential

This endpoint allows for the creation or update (upsert) of a driver's credential. The credential information can include certification and expiration dates, as well as other relevant metadata for the driver and credential.

Required Scopes (io.w)

Request

driver_id: str
The unique identifier for the driver. This is required to link the credential to the correct driver.

---

credential_id: str
The unique identifier for the credential. This is required to identify the specific credential being upserted.

---

certification_date: datetime | None = None
The date when the credential was certified. If provided, it will be stored and used to calculate the expiration date.

---

expiration_date: datetime | None = None
The date when the credential expires. If certification_date is provided without this field, the expiration date will be computed based on the days_valid value.

note

Either certification_date or expiration_date is required. If both are provided, the certification_date will be stored.

Response

errors: list[dict]
A list of errors that occurred during the upsert process, including the request and error description.

---

updated: int
The number of credentials that were successfully updated.

Responses

200

Successful Response

422

Validation Error

application/json

Example (from schema)

{
  "detail": [
    {
      "loc": [
        "string",
        0
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}

Loading...