Delete Boat

Permanently delete a boat listing and all associated data. The requesting user must be an admin or owner of the company that owns the boat.

Authentication

Requires one of:

• API key: X-API-Key header with your owner API key (cb_live_*)
• Session: Authenticated user session (cookie-based)

Path Parameters

Prerequisites

The boat must have no open bookings. Open booking statuses are:

• pending -- awaiting owner approval
• accepted -- awaiting guest payment
• confirmed -- paid and scheduled

Cancel or complete all bookings before deleting.

Request

# Delete with API key
curl -X DELETE https://charter.boats/api/boats/550e8400-e29b-41d4-a716-446655440000 \
  -H "X-API-Key: cb_live_your_api_key"
 
# Delete with session
curl -X DELETE https://charter.boats/api/boats/550e8400-e29b-41d4-a716-446655440000 \
  -H "Cookie: session=..."

Response

{
  "deleted": true,
  "title": "Škuribanda"
}

What Gets Deleted

When a boat is deleted, the following data is permanently removed:

• Boat record and all fields
• Seasonal prices (boat_prices) and fees (boat_fees)
• All boat images and videos (database records)
• Amenity associations and custom amenities
• Calendar blocks, external events, and external holds
• Calendar sources (iCal imports)
• Favorites from all users
• Coupon associations, availability-change rows, activity-log rows, and marketing ads

Bookings are not deleted. Boats with open bookings (pending, accepted, or confirmed) cannot be deleted at all — the request is rejected. Any imported Boataround mapping is unlinked rather than removed.

Errors