kegs

Changed on

Adds a new keg to the keg room (unattached).

post/api/kegs

Request

  • The document declares no server URL.
  • Auth: one of:
    • HTTP basic
    • API key in cookie sessionid

Request body

beverage_idinteger nullable
beverage_namestring
beverage_type'beer' | 'wine' | 'soda' | 'kombucha' | 'other'
  • beer - Beer
  • wine - Wine
  • soda - Soda
  • kombucha - Kombucha
  • other - Other/Unknown
producer_namestring
style_namestring
keg_type'mini' | 'corny-2_5-gal' | 'corny-3-gal' | 'corny' | 'sixth' | 'euro-30-liter' | 'euro-half' | 'quarter' | 'euro' | 'half-barrel' | 'other'
  • mini - Mini Keg (5 L)
  • corny-2_5-gal - Corny Keg (2.5 gal)
  • corny-3-gal - Corny Keg (3.0 gal)
  • corny - Corny Keg (5 gal)
  • sixth - Sixth Barrel (5.17 gal)
  • euro-30-liter - European DIN (30 L)
  • euro-half - European Half Barrel (50 L)
  • quarter - Quarter Barrel (7.75 gal)
  • euro - European Full Barrel (100 L)
  • half-barrel - Half Barrel (15.5 gal)
  • other - Other
full_volume_mlnumber double nullable
descriptionstring
notesstring

Response

idinteger required
keg_type'mini' | 'corny-2_5-gal' | 'corny-3-gal' | 'corny' | 'sixth' | 'euro-30-liter' | 'euro-half' | 'quarter' | 'euro' | 'half-barrel' | 'other'
  • mini - Mini Keg (5 L)
  • corny-2_5-gal - Corny Keg (2.5 gal)
  • corny-3-gal - Corny Keg (3.0 gal)
  • corny - Corny Keg (5 gal)
  • sixth - Sixth Barrel (5.17 gal)
  • euro-30-liter - European DIN (30 L)
  • euro-half - European Half Barrel (50 L)
  • quarter - Quarter Barrel (7.75 gal)
  • euro - European Full Barrel (100 L)
  • half-barrel - Half Barrel (15.5 gal)
  • other - Other
served_volume_mlnumber double required

Computed served volume.

full_volume_mlnumber double

Full volume of this Keg; usually set automatically from keg_type.

start_timestring date-time required

Time the Keg was first tapped.

end_timestring date-time required

Time the Keg was finished or disconnected.

status'available' | 'on_tap' | 'finished' required
  • available - Available
  • on_tap - On tap
  • finished - Finished
descriptionstring nullable

User-visible description of the Keg.

spilled_mlnumber double required

Amount of beverage poured without an associated Drink.

notesstring nullable

Private notes about this keg, viewable only by admins.

illustrationstring uri required
illustration_thumbnailstring uri required
statsunknown required

Changes

  • 8d1d025a79e9Revision changes
    • info

      removed the required write-only property beverage/allOf[Beverage]/producer_id from the response with the status