PATCH /holders/cancel/:holdersId
Cancel a pending order. Only orders in PENDING_PAYMENT can be
cancelled. Once the worker moves the order to RUNNING the SOL has
been spent and cancellation is not supported.
Frees the singleton slot so the user can initialize a new order.
Use case
User changed their mind or picked the wrong pool before payment — release the pending order and start over.
Path params
| Param | Required | Description |
|---|---|---|
holdersId | yes | Order id. |
Response 200
{ "holdersId": "…", "status": "CANCELLED", "message": "Order cancelled" }
Errors
| Status | Meaning |
|---|---|
400 | Order not in PENDING_PAYMENT. |
404 | Order not found or not owned. |
Example
curl -X PATCH "$BASE_URL/holders/cancel/66b4…" \
-H "Authorization: Bearer $ACCESS" \
-H "x-user-id: $USER_ID"