Sign in
Auctions

Update Auction metadata (admin)

Changed on

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

patch/api/v1/admin/auctions/{auctionId}

Request

  • Base URL: https://api.stage.aura-historia.com
  • URL: https://api.stage.aura-historia.com/api/v1/admin/auctions/{auctionId}
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Path parameters

auctionIdstring required

Strict auc_ UUIDv7 TypeID. Auction identity and source key are immutable.

Request body

expectedVersioninteger required
catalogueUrlstring uri nullable
format'LIVE' | 'TIMED'
reportedStatus'SCHEDULED' | 'IN_PROGRESS' | 'ENDED' | 'POSTPONED' | 'CANCELLED'
reportedLotCountinteger nullable

Example request

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

Response

Updated administrative Auction data. Always Cache-Control: no-store.

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

Example response

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

Changes