Update a Shipment Exception

PATCH /shipment_exceptions/{shipment_exception_id}

Update an existing Shipment Exception

Headers

  • Authorization string Required

    Authorize your API calls with an Arta API token

Path parameters

application/json

Body

  • shipment_exception object Required

    Additional properties are allowed.

    Hide shipment_exception attributes Show shipment_exception attributes object
    • hold_until string

      Optionally provide a date to hold collection for the shipment. Values should be in the YYYY-MM-DD format. Hold until dates must be fewer than 30 days from the shipment's created_at datetime.

    • status string

      The current status for this exception

Responses

  • 200 application/json

    Successful Shipment Exception response

    Hide headers attributes Show headers attributes
    Hide response attributes Show response attributes object
    • created_at string(date-time)

      A NaiveDatetime-formatted timestamp describing when the exception was created with microsecond precision

    • exception_type_label string | null

      An additional label providing context about the exception type (optional)

    • hold_until string(date) | null

      The date the shipment will be held until

    • id string(uuid)

      The id of the exception in UUID format

    • package_id integer(int64) | null

      The package associated with this exception (optional)

    • resolution string | null

      A brief description of the method by which this exception was resolved

    • shipment_id string(uuid)

      The id of the shipment associated with this exception

    • source string

      The source of the exception

    • status string

      The current status for this exception

      Values are new, in_progress, or resolved.

    • type string

      The type of exception

    • updated_at string(date-time)

      A NaiveDatetime-formatted timestamp describing when the exception was last updated with microsecond precision
  • 404 application/json

    Not Found

    Hide headers attributes Show headers attributes
    Hide response attribute Show response attribute object
    • errors object

      Additional properties are allowed.

      Hide errors attribute Show errors attribute object
PATCH /shipment_exceptions/{shipment_exception_id} 
curl \
 -X PATCH https://api.arta.io/shipment_exceptions/{shipment_exception_id} \
 -H "Content-Type: application/json" \
 -H "Authorization: ARTA_APIKey s0e1t2e3c4a5s6t7r8o9n10o11m12y" \
 -d '{"shipment_exception":{"status":"resolved","hold_until":"2023-08-15"}}'
Request example 
{
  "shipment_exception": {
    "status": "resolved",
    "hold_until": "2023-08-15"
  }
}
Response examples (200) 
{
  "id": "d686ad3b-33fd-454c-a7aa-94b1ecbc539f",
  "type": "held_at_customs",
  "source": "api",
  "status": "new",
  "created_at": "2023-05-26T19:33:19.693833",
  "hold_until": null,
  "package_id": 4366794,
  "resolution": null,
  "updated_at": "2023-05-26T19:33:19.693833",
  "shipment_id": "a5cbb58c-43ab-4658-9999-98a33b0070d5",
  "exception_type_label": null
}
Response examples (404) 
# Headers
content-type: application/json
x-arta-request-id: FkBjuxbwLLTx4RoAARkx

# Payload
{
  "errors": {
    "detail": "string"
  }
}