Skip to main content
PUT
/
fulfillments
/
events
/
{eventId}
Update Fulfillment Event
curl --request PUT \
  --url https://staging-api.puppetvendors.com/fulfillments/events/{eventId} \
  --header 'Content-Type: application/json' \
  --header 'x-access-token: <api-key>' \
  --data '
{
  "lineItemId": "<string>",
  "status": "<string>",
  "happenedAt": "<string>",
  "city": "<string>",
  "province": "<string>",
  "country": "<string>",
  "message": "<string>"
}
'
V2 Preview — This endpoint is part of the V2 API preview. Breaking changes may occur.

​
Overview

Update an existing fulfillment event. lineItemId is required in the body to identify the parent line item.

​
Path Parameters

​
eventId
string
required
Event ObjectId.

​
Request Body

​
lineItemId
string
required
Parent line item ObjectId.
​
status
string
One of in_transit, out_for_delivery, delivered, failed_delivery.
​
happenedAt
string
ISO 8601 timestamp.
​
city
string
​
province
string
​
country
string
​
message
string

​
Response

200
{
  "success": true,
  "data": {
    "_id": "507f1f77bcf86cd799439020",
    "status": "delivered"
  }
}

​
Example

curl -X PUT "https://staging-api.puppetvendors.com/fulfillments/events/507f1f77bcf86cd799439020" \
  -H "x-access-token: YOUR_VENDOR_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "lineItemId": "507f1f77bcf86cd799439015",
    "status": "delivered"
  }'