Maintenance

Create a mechanic DVIR

Creates a new mechanic DVIR in the organization.

Submit Feedback: Likes, dislikes, and API feature requests should be filed as feedback in our <a href="https://forms.gle/zkD4NCH7HjKb7mm69" target="_blank">API feedback form</a>. If you encountered an issue or noticed inaccuracies in the API documentation, please <a href="https://www.samsara.com/help" target="_blank">submit a case</a> to our support team.

To use this endpoint, select Write DVIRs under the Maintenance category when creating or editing an API token. <a href="https://developers.samsara.com/docs/authentication#scopes-for-api-tokens" target="_blank">Learn More.</a>

post/fleet/dvirs

Request

Base URL
https://api.samsara.com
Auth
HTTP bearer

Request body

authorIdstring required

Samsara user ID of the mechanic creating the DVIR.

licensePlatestring

The license plate of this vehicle.

locationstring

Optional string if your jurisdiction requires a location of the DVIR.

mechanicNotesstring

The mechanics notes on the DVIR.

odometerMetersinteger

The odometer reading in meters.

resolvedDefectIdsstring[]

Array of ids for defects being resolved with this DVIR.

safetyStatus'safe' | 'unsafe' required

Whether or not this vehicle or trailer is safe to drive.

trailerIdstring

Id of trailer being inspected. Either vehicleId or trailerId must be provided.

type'mechanic' required

Only type 'mechanic' is currently accepted.

vehicleIdstring

Id of vehicle being inspected. Either vehicleId or trailerId must be provided.

Example request

{
  "authorId": "11",
  "licensePlate": "XHK1234",
  "location": "350 Rhode Island St Ste. 400S, San Francisco, CA 94103",
  "mechanicNotes": "Replaced headlight on passenger side.",
  "odometerMeters": 14010293,
  "safetyStatus": "safe",
  "trailerId": "11",
  "type": "mechanic",
  "vehicleId": "10"
}

Response

Newly created DVIR.

Example response

{
  "data": {
    "authorSignature": {
      "signatoryUser": {
        "id": "88668",
        "name": "Susan Bob"
      },
      "signedAtTime": "2020-01-27T07:06:25Z",
      "type": "driver"
    },
    "endTime": "2020-01-27T07:06:25Z",
    "id": "7107471",
    "licensePlate": "XHK1234",
    "location": "350 Rhode Island St Ste. 400S, San Francisco, CA 94103",
    "mechanicNotes": "Replaced headlight on passenger side.",
    "odometerMeters": 14010293,
    "safetyStatus": "unsafe",
    "secondSignature": {
      "signatoryUser": {
        "id": "88668",
        "name": "Susan Bob"
      },
      "signedAtTime": "2020-01-27T07:06:25Z",
      "type": "driver"
    },
    "startTime": "2020-01-27T07:06:25Z",
    "thirdSignature": {
      "signatoryUser": {
        "id": "88668",
        "name": "Susan Bob"
      },
      "signedAtTime": "2020-01-27T07:06:25Z",
      "type": "driver"
    },
    "trailer": {
      "id": "123456789",
      "name": "Midwest Trailer #5"
    },
    "trailerDefects": [
      {
        "comment": "Air Compressor not working",
        "createdAtTime": "2020-01-27T07:06:25Z",
        "defectType": "Air Compressor",
        "id": "18",
        "isResolved": true,
        "mechanicNotes": "Extremely large oddly shaped hole in passenger side window.",
        "mechanicNotesUpdatedAtTime": "2020-01-27T07:06:25Z",
        "resolvedAtTime": "2020-01-27T07:06:25Z",
        "resolvedBy": {
          "id": "11",
          "name": "Christopher 'The Handyman' Zhen"
        },
        "trailer": {
          "id": "123456789",
          "name": "Midwest Trailer #5"
        },
        "vehicle": {
          "ExternalIds": {
            "maintenanceId": "250020",
            "payrollId": "ABFS18600"
          },
          "id": "123456789",
          "name": "Midwest Truck #4"
        }
      }
    ],
    "trailerName": "Midwest Trailer #5",
    "type": "preTrip",
    "vehicle": {
      "ExternalIds": {
        "maintenanceId": "250020",
        "payrollId": "ABFS18600"
      },
      "id": "123456789",
      "name": "Midwest Truck #4"
    },
    "vehicleDefects": [
      {
        "comment": "Air Compressor not working",
        "createdAtTime": "2020-01-27T07:06:25Z",
        "defectType": "Air Compressor",
        "id": "18",
        "isResolved": true,
        "mechanicNotes": "Extremely large oddly shaped hole in passenger side window.",
        "mechanicNotesUpdatedAtTime": "2020-01-27T07:06:25Z",
        "resolvedAtTime": "2020-01-27T07:06:25Z",
        "resolvedBy": {
          "id": "11",
          "name": "Christopher 'The Handyman' Zhen"
        },
        "trailer": {
          "id": "123456789",
          "name": "Midwest Trailer #5"
        },
        "vehicle": {
          "ExternalIds": {
            "maintenanceId": "250020",
            "payrollId": "ABFS18600"
          },
          "id": "123456789",
          "name": "Midwest Truck #4"
        }
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.