Skip to main content

Documentation Index

Fetch the complete documentation index at: https://api.docs.onlydrams.app/llms.txt

Use this file to discover all available pages before exploring further.

Only the user who created a private bottle can edit it. Public bottles cannot be edited.

Parameters

id
uuid
required
The bottle ID (in URL path).
name
string
The name of the bottle/spirit. Updates the associated Juice record.
price
number
The MSRP/retail price for the bottle.
size
string
The size of the bottle in mL (e.g., “750”, “1000”, “1750”).
proof
number
The alcohol proof. Updates the associated Juice record.
distillery
object
The distillery reference. Only id is required.
category
object
The category reference. Only id is required.
subcategory
object
The subcategory reference. Only id is required.
upc
object
The UPC barcode. A bottle can only have one UPC—setting a new one replaces any existing UPC.

Returns

Returns a success message if the request was successful, otherwise it returns an error message.
curl -X PATCH https://api.onlydrams.app/api/v1/bottles/abc123-def456 \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer $ACCESS_TOKEN" \
     -d '{
          "bottle": {
            "name": "Buffalo Trace Bourbon",
            "price": 29.99,
            "size": "750",
            "proof": 90,
            "front_label": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8DwHwAFBQIAX8jx0gAAAABJRU5ErkJggg==",
            "distillery": {
              "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
            },
            "category": {
              "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901"
            },
            "subcategory": {
              "id": "c3d4e5f6-a7b8-9012-cdef-123456789012"
            },
            "upc": {
              "code": "080244001001"
            }
          }
        }'