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)
- Cannot be removed if it is already the winning bid (status: accepted)
Typical flow:
- Carrier reviews their active bids
- Selects a bid to remove
- If 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
Response Headers
Error in the request. Possible causes:
- Auction not found or invalid
- Bid cannot be removed in the current state
Response Headers
Unauthorized
Response Headers
Access denied. Possible causes:
- User not active
- Bid does not belong to the user
- No permission to delete this bid
Response Headers
Not found. Possible causes:
- Auction does not exist
- Bid does not exist
Response Headers
Conflict. Possible causes:
- Auction already awarded
- Bid already accepted
- Time restrictions