Update Listing Status
Endpoint
Section titled “Endpoint”PUT /api/v1/listing/{referenceId}/update
Description
Section titled “Description”Updates the status of an existing listing, Status changes follow a strict workflow - only valid transitions are allowed
Headers
Section titled “Headers”{ "Content-Type": "application/json", "Authorization": "Bearer <token>"}Path Parameters
Section titled “Path Parameters”| Parameter | Required | Description |
|---|---|---|
| referenceId | Yes | The listing’s unique reference ID received during creation |
| toStatus | Yes | Target status. Must be one of: “delivering”, “delivered”, “cancelled” |
Response
Section titled “Response”{ "success": true}Error Codes
Section titled “Error Codes”- 400: Invalid status transition
- 404: Listing not found
- 500: Internal server error
Example
Section titled “Example”curl -X PUT \ 'https://provider.nazel.sa/api/v1/listing/ref123/update?toStatus=delivered' \ -H 'Authorization: Bearer your_token'