Auctions

Create a source-scoped Auction (admin)

Delegated Aura access tokens require auctions:write; missing scope returns 403 FORBIDDEN.

post/api/v1/admin/auctions

Request

listingSourceIdstring required

Strict ListingSource TypeID.

sourceAuctionIdstring required

1–512 UTF-8 bytes after outer Unicode-whitespace trimming; case and internal whitespace are preserved.

catalogueUrlstring uri

format'LIVE' | 'TIMED'

reportedStatus'SCHEDULED' | 'IN_PROGRESS' | 'ENDED' | 'POSTPONED' | 'CANCELLED'

reportedLotCountinteger

{
  "name": {
    "language": "de"
  }
}

Auction created. Location names the new admin detail resource.

auctionIdstring required

Strict auc_ UUIDv7 TypeID.

listingSourceIdstring required

sourceAuctionIdstring required

catalogueUrlstring uri nullable required

format'LIVE' | 'TIMED' required

reportedStatus'SCHEDULED' | 'IN_PROGRESS' | 'ENDED' | 'POSTPONED' | 'CANCELLED' required

reportedLotCountinteger nullable required

expectedVersioninteger required

createdstring date-time required

updatedstring date-time required

{
  "name": {
    "language": "de"
  }
}