Maintenance

Resolve a DVIR

Resolves a given DVIR by marking its isResolved field to true.

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>

patch/fleet/dvirs/{id}

Request

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

Path parameters

idstring required

ID of the DVIR.

Request body

authorIdstring required

The user who is resolving the dvir.

isResolvedboolean required

Resolves the DVIR. Must be true.

mechanicNotesstring

The mechanics notes on the DVIR.

signedAtTimestring

Time when user signed this DVIR. Defaults to now. UTC timestamp in RFC 3339 format. Example: 2020-01-27T07:06:25Z.

Example request

{
  "authorId": "11",
  "mechanicNotes": "Replaced headlight on passenger side.",
  "signedAtTime": "2020-01-27T07:06:25Z"
}

Response

Updated dvir object with ID.

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.