---
title: "Updates an existing appointment with a new status, start time, and/or end time. Requires the client to send at least one of new `windowStart` time, new `windowEnd` time, or `appointmentConfirmed`."
method: POST
path: "/shipments/appointment"
tags: ["Carrier"]
---

# Updates an existing appointment with a new status, start time, and/or end time. Requires the client to send at least one of new `windowStart` time, new `windowEnd` time, or `appointmentConfirmed`.

`POST /shipments/appointment`

## Request body

- UpdateShipmentRequest
  - `shipmentReference` string
  - `stopId` string
  - `windowStart` string, date-time
  - `windowEnd` string, date-time
  - `appointmentConfirmed` boolean

## Response `200`

Status Code 200:  Successful Response - the request was successful!

- UpdateShipmentResponse
  - `success` boolean
  - `stop` object
    - `stopId` string
    - `status` string
    - `locationName` string
    - `locationAddress` string
    - `windowStart` string, date-time
    - `windowEnd` string, date-time
    - `appointmentConfirmed` boolean
    - `complete` boolean
    - `missingDocs` boolean
    - `off_site` boolean
    - `sequence` integer

## Other responses

- `400` — Status Code 400: Bad Request Response - the request header and/or body is invalid
- `500` — StatusCode 500: Internal Server Error Response - there's a problem with the Public API service

---

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