Skip to main content

Edit existing auction

PUT 
/api/auction/:serviceCode

Allows editing the details of an existing auction in the 'draft' or 'published' state.

Requirements:

  • The auction must exist and belong to the user's company
  • Only auctions in the 'draft' or 'published' state can be edited
  • The user must have edit permissions

Validations performed:

  1. Verifies that the auction exists and is editable
  2. Validates times and dates (etl_date < etd_date)
  3. Checks cargo dimensions (weight > 0, height > 0)
  4. Verifies load/unload addresses

Editable fields:

  • etl_date: Load date/time
  • etd_date: Unload date/time
  • cargo_weight: Cargo weight (kg)
  • cargo_height: Cargo height (m)
  • etl_address/etd_address: Address IDs
  • description: Additional description
  • pallets_type: Pallets type
  • pallets_num: Number of pallets

Example request body:

{
  etl_date: 2025-08-15T08:00:00Z,
  etd_date: 2025-08-15T18:00:00Z,
  cargo_weight: 1500,
  cargo_height: 2.8,
  etl_address: 60a1b2c3d4e5f6a1b2c3d4e5,
  etd_address: 60a1b2c3d4e5f6a1b2c3d4e6,
  description: Urgent perishable goods shipment
}

The response includes the updated auction with the new values.

Request​

Responses​

Single Auction