---
title: "Modify a Driving Period"
method: PUT
path: "/v1/driving_periods/{id}"
---

# Modify a Driving Period

`PUT /v1/driving_periods/{id}`

## Request

- Base URL: `https://api.gomotive.com`
- URL: `https://api.gomotive.com/v1/driving_periods/{id}`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/gomotive/apis/motive/docs/v1/driving_periods/:id/put.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `id` integer, required

## Request body

- object
  - `driver_id` integer: Specify the ID of the driver for whom you want to modify the Driving Period.
  - `notes` string: Specify the notes of the Driving Period that you want to modify.

## Response `200`

200

- object
  - `driving_period` object
    - `id` integer
    - `start_time` string
    - `end_time` unknown
    - `status` string
    - `type` string
    - `annotation_status` unknown
    - `notes` unknown
    - `duration` number
    - `start_kilometers` number
    - `end_kilometers` unknown
    - `source` unknown
    - `driver` object
      - `id` integer
      - `first_name` string
      - `last_name` string
      - `email` string
      - `username` string
      - `driver_company_id` string
    - `vehicle` object
      - `id` integer
      - `number` string
      - `year` string
      - `make` string
      - `model` string
      - `vin` string
      - `metric_units` boolean
    - `origin` string
    - `origin_lat` integer
    - `origin_lon` integer
    - `destination_lat` unknown
    - `destination_lon` unknown
    - `destination` string
    - `distance` unknown
    - `start_hvb_state_of_charge` unknown
    - `end_hvb_state_of_charge` unknown
    - `start_hvb_lifetime_energy_output` unknown
    - `end_hvb_lifetime_energy_output` unknown

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/gomotive/apis/motive.md) - [All operations](https://skmtc.dev/gomotive/apis/motive/llms.txt) - [OpenAPI document](https://skmtc.dev/gomotive/apis/motive/revisions/c71780e497f5?raw)