---
title: "Update waypoint by id"
method: PATCH
path: "/waypoints/{id}"
tags: ["Waypoints"]
---

# Update waypoint by id

`PATCH /waypoints/{id}`

Update waypoint by id

## Path parameters

- `id` integer, required

## Request body

- object
  - `scheduledDate` string, date-time — Waypoint scheduled date
  - `poiId` number — Poi id processed on waypoint
  - `visited` boolean — Waypoint visited
  - `longitude` number — Waypoint visited exact location longitude
  - `latitude` number — Waypoint visited exact location latitude
  - `vehicleId` number — Waypoint vehicle assigned
  - `visitedAt` string, date-time — Waypoint visit date
  - `visitDuration` integer — Waypoint visit duration
  - `totalValue` number — Waypoint total amount
  - `pallets` number — Waypoint pallets
  - `createdAt` string, date-time — Waypoint created date
  - `departedAt` string, date-time — Waypoint departure date
  - `comments` string — Waypoint comments
  - `scheduledArrivalTimestamp` string, date-time — Waypoint scheduled visit arrival
  - `scheduledDepartureTimestamp` string, date-time — Waypoint scheduled visit departure
  - `visitOrder` integer — Waypoint visit order
  - `activities` object
    - `type` 'pickup' | 'task' | 'delivery' — Activity type
    - `orders` object[]
      - `_id` union — Order ID
        - integer
        - string
      - `weight` union — Weight
        - integer
        - string
      - `deliveredWeight` union — Delivered weight
        - integer
        - string
    - `tasks` object[]
      - `_id` union — Task ID
        - integer
        - string

## Response `200`

Updated waypoint

- object
  - `meta` object
    - `error` number — Error number
    - `message` string — Error message
  - `data` object
    - `scheduledDate` string, date-time — Waypoint scheduled date
    - `poiId` number — Poi id processed on waypoint
    - `visited` boolean — Waypoint visited
    - `longitude` number — Waypoint visited exact location longitude
    - `latitude` number — Waypoint visited exact location latitude
    - `vehicleId` number — Waypoint vehicle assigned
    - `visitedAt` string, date-time — Waypoint visit date
    - `visitDuration` integer — Waypoint visit duration
    - `totalValue` number — Waypoint total amount
    - `pallets` number — Waypoint pallets
    - `createdAt` string, date-time — Waypoint created date
    - `departedAt` string, date-time — Waypoint departure date
    - `comments` string — Waypoint comments
    - `scheduledArrivalTimestamp` string, date-time — Waypoint scheduled visit arrival
    - `scheduledDepartureTimestamp` string, date-time — Waypoint scheduled visit departure
    - `visitOrder` integer — Waypoint visit order
    - `activities` object
      - `type` 'pickup' | 'task' | 'delivery' — Activity type
      - `orders` object[]
        - `_id` union — Order ID
          - integer
          - string
        - `weight` union — Weight
          - integer
          - string
        - `deliveredWeight` union — Delivered weight
          - integer
          - string
      - `tasks` object[]
        - `_id` union — Task ID
          - integer
          - string

## Other responses

- `400` — On Error, response will contain an error and message with these posible values ### Error codes: Code | Description | Field ----------------|-------------|------------- 2027 | Order id not found or not allowed for this user | orderId 2045 | Waypoint id not found or not allowed for this user | _id 2046 | Route id not found or not allowed for this user | _id 2047 | Poi id not found or not allowed for this user | _id 2048 | Vehicle id not found or not allowed for this user | 2053 | Task id not found or not allowed for this user | taskId
- `403` — Not authorized access

---

[API](https://skmtc.net/quadminds/apis/quadminds-api-v2.md) · [All operations](https://skmtc.net/quadminds/apis/quadminds-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/quadminds/quadminds-api-v2/revisions/e0ab56dece05/schema)