diff --git a/content/api/shipments.md b/content/api/shipments.md
index d989dd401..1e7cf2235 100644
--- a/content/api/shipments.md
+++ b/content/api/shipments.md
@@ -38,17 +38,10 @@ Assuming in this instance that you want to create a shipment with a stock_locati
 
 <%= admin_only %>
 
-To update a shipment, make a request like this:
+To update shipment information, make a request like this:
 
 ```text
-PUT /api/orders/R1234567/shipments/H123456789```
-
-To update shipment information, use parameters like this:
-
-<%= json \
- :shipment => {
-   :tracking=>"TRK9000"
- } %>
+PUT /api/orders/R1234567/shipments/H123456789?shipment[tracking]=TRK9000```
 
 ### Parameters