Download OpenAPI specification:Download
Enables Home Brew Masters to programmatically manage their Tapboard
Retrieve a Tapboard that belongs to you.
boardID required | string The ID of the Tapboard to retrieve. |
{- "id": "string",
- "pk": "string",
- "sk": "string",
- "itemType": "board",
- "createdAt": "string",
- "updatedAt": "string",
- "GSI1PK": "string",
- "GSI1SK": "string",
- "userID": "string",
- "hasAds": true,
- "hasMinimalBranding": true,
- "name": "string",
- "layout": "1-COL",
- "font": "Pangolin",
- "fontSize": 100,
- "textColor": "string",
- "background": "chalkboard",
- "beverages": [
- {
- "id": "string",
- "name": "string",
- "description": "string",
- "style": "string",
- "abv": 0,
- "ibu": 0,
- "color": "string",
- "temp": 0,
- "volume": 0,
- "volumeUnit": "string",
- "icon": "SHAKER_PINT"
}
]
}
Update a Tapboard that belongs to you.
boardID required | string The ID of the Tapboard to update. |
The updated Tapboard. Must include all ID fields, and any differences to mutable fields will overwrite the persisted Tapboard.
id required | string Entity ID (immutable) |
pk required | string Internal ID (immutable) |
sk required | string Internal ID (immutable) |
itemType required | string Value: "board" Internal indicator, will always be "board" (immutable) |
createdAt required | string\d{4}-[01]\d-[0-3]\dT[0-2]\d:[0-5]\d:[0-5]\d\... ISO date when the entity was created (immunable) |
updatedAt required | string\d{4}-[01]\d-[0-3]\dT[0-2]\d:[0-5]\d:[0-5]\d\... ISO date when the entity was last updated (immutable) |
GSI1PK required | string Internal ID (immutable) |
GSI1SK required | string Internal ID (immutable) |
userID required | string The ID of the Tapboard's owner (immutable) |
hasAds | boolean Internal indicator of owner's permissions (immutable). |
hasMinimalBranding | boolean Internal indicator of owner's permissions (immutable). |
name required | string <= 50 characters The name of the Tapboard. Visible to users. |
layout | string Default: "2-COL" Enum: "1-COL" "2-COL" The layout of the Tapboard in full screen mode. |
font | string Default: "Pangolin" Enum: "Pangolin" "Chelsea Market" "Permanent Marker" "Roboto" "Open Sans" "Nato Sans" "Montserrat" "Roboto Mono" The font used to display the Tapboard. |
fontSize | number Default: 100 Percentage adjustment to the default font size of 14px |
textColor | string The color (hex or rgb()) of the Tapboard's font. |
string or string Default: "chalkboard" The background texture of the Tapboard. | |
Array of objects Set of Beverages. |
{- "id": "string",
- "pk": "string",
- "sk": "string",
- "itemType": "board",
- "createdAt": "string",
- "updatedAt": "string",
- "GSI1PK": "string",
- "GSI1SK": "string",
- "userID": "string",
- "hasAds": true,
- "hasMinimalBranding": true,
- "name": "string",
- "layout": "1-COL",
- "font": "Pangolin",
- "fontSize": 100,
- "textColor": "string",
- "background": "chalkboard",
- "beverages": [
- {
- "id": "string",
- "name": "string",
- "description": "string",
- "style": "string",
- "abv": 0,
- "ibu": 0,
- "color": "string",
- "temp": 0,
- "volume": 0,
- "volumeUnit": "string",
- "icon": "SHAKER_PINT"
}
]
}
{- "id": "string",
- "pk": "string",
- "sk": "string",
- "itemType": "board",
- "createdAt": "string",
- "updatedAt": "string",
- "GSI1PK": "string",
- "GSI1SK": "string",
- "userID": "string",
- "hasAds": true,
- "hasMinimalBranding": true,
- "name": "string",
- "layout": "1-COL",
- "font": "Pangolin",
- "fontSize": 100,
- "textColor": "string",
- "background": "chalkboard",
- "beverages": [
- {
- "id": "string",
- "name": "string",
- "description": "string",
- "style": "string",
- "abv": 0,
- "ibu": 0,
- "color": "string",
- "temp": 0,
- "volume": 0,
- "volumeUnit": "string",
- "icon": "SHAKER_PINT"
}
]
}
Update a single Beverage on a Tapboard that belongs to you.
boardID required | string The ID of the Tapboard to update. |
beverageID required | string The ID of the Beverage to update. |
The updated Beverage. May include any fields, and any differences to mutable fields will overwrite the persisted Beverage. There is no way to unset a value, it is best to set it to its default.
id required | string <= 32 characters ^[A-Za-z0-9\-]*$ The ID of the Beverage for use with API access. This is not used by Tapboard so it can be changed at any time. |
name required | string <= 100 characters The name of the Beverage. Visible to users. |
description required | string <= 300 characters The short description of the Beverage. Visible to users. |
style | string <= 50 characters The style of Beverage. Any value less than or equal to 50 characters can be used. |
abv | number The Beverage's ABV |
ibu | number The Beverage's IBU |
color | string <= 30 characters The Beverage's color in hex or rgb() |
temp | number The Beverage's current temperature. Best when used with a connected digital thermometer. |
volume | number The Beverage's current volume. Use |
volumeUnit | string The unit to display for the Beverage's current volume. |
icon | string Enum: "SHAKER_PINT" "IMPERIAL_PINT" "PILSNER" "WEISEN" "SNIFTER" "THISTLE" "CHALICE" "WINE" "CAN" The icon to use for this beverage. Generally a representation of the Beverage style. |
{- "id": "string",
- "name": "string",
- "description": "string",
- "style": "string",
- "abv": 0,
- "ibu": 0,
- "color": "string",
- "temp": 0,
- "volume": 0,
- "volumeUnit": "string",
- "icon": "SHAKER_PINT"
}
{- "id": "string",
- "pk": "string",
- "sk": "string",
- "itemType": "board",
- "createdAt": "string",
- "updatedAt": "string",
- "GSI1PK": "string",
- "GSI1SK": "string",
- "userID": "string",
- "hasAds": true,
- "hasMinimalBranding": true,
- "name": "string",
- "layout": "1-COL",
- "font": "Pangolin",
- "fontSize": 100,
- "textColor": "string",
- "background": "chalkboard",
- "beverages": [
- {
- "id": "string",
- "name": "string",
- "description": "string",
- "style": "string",
- "abv": 0,
- "ibu": 0,
- "color": "string",
- "temp": 0,
- "volume": 0,
- "volumeUnit": "string",
- "icon": "SHAKER_PINT"
}
]
}