Delete an existing bid
DELETE/truckers/auctions/bid/:serviceCode
Allows a carrier to remove an existing bid in an auction.
Requirements:
- Authenticated and active user.
- The bid must belong to the user or their company.
- The auction must be in a state that allows bid removal (published).
- It cannot be removed if it is already the winning bid (status: accepted).
Typical Flow:
- The carrier queries their active bids.
- They select a bid to remove.
- If the conditions are met, the bid is marked as cancelled.
- If it was the lowest bid, the auction's winning bid is updated.
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 409
Bid successfully removed.
Error in the request. Possible causes:
- Auction not found or invalid
- Bid cannot be deleted in the current state
Unauthorized
Access denied. Possible causes:
- User not active
- Bid does not belong to the user
- No permission to delete this bid
Not found. Possible causes:
- Auction does not exist
- Bid does not exist
Conflict. Possible causes:
- Auction already awarded
- Bid already accepted
- Time restrictions