{"openapi":"3.1.0","info":{"title":"Liquid Death API (Bowmark)","version":"e833508f87ff","description":"Liquid Death's live storefront: search the catalogue, read one product's real variants, prices and per-size stock, and hand the shopper a filled cart to open.\n\nEvery function Bowmark has for Liquid Death (liquiddeath.com) as one HTTP call. Each runs on Bowmark's infrastructure with the same billing, rules and response envelope as `POST /v1/run`. The whole API: https://api.bowmark.ai/openapi.json. Guide: https://bowmark.ai/docs/api.","contact":{"email":"support@bowmark.ai","url":"https://bowmark.ai/docs/api"}},"servers":[{"url":"https://api.bowmark.ai"}],"security":[{"bearer":[]},{"apiKeyHeader":[]}],"paths":{"/v1/sites/liquiddeath/searchProducts":{"post":{"operationId":"searchProducts","summary":"Searches Liquid Death's live catalogue and returns matching products with their real variants, current prices and per-variant stock.","description":"Searches Liquid Death's live catalogue and returns matching products with their real variants, current prices and per-variant stock. Matches whole words, so 'tee' finds tees and not 'Steel'. Returns [] when nothing matches, which is an ordinary answer rather than an error.\n\nCalls `bowmark.providers.liquiddeath.searchProducts`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<LiquiddeathProduct[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"TypeScript: `string`"},"opts":{"type":"object","properties":{"productType":{"type":"string"},"inStockOnly":{"type":"boolean"},"limit":{"type":"number"}},"additionalProperties":true,"description":"TypeScript: `{ productType?: string; inStockOnly?: boolean; limit?: number }`"}},"required":["query"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/liquiddeath/listProducts":{"post":{"operationId":"listProducts","summary":"Lists products from Liquid Death's live catalogue without a search term, supporting the same filters as searchProducts (product type, stock, limit).","description":"Lists products from Liquid Death's live catalogue without a search term, supporting the same filters as searchProducts (product type, stock, limit). Returns products in stored order. Returns [] if no products match the filters.\n\nCalls `bowmark.providers.liquiddeath.listProducts`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<LiquiddeathProduct[]>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"opts":{"type":"object","properties":{"productType":{"type":"string"},"inStockOnly":{"type":"boolean"},"limit":{"type":"number"}},"additionalProperties":true,"description":"TypeScript: `{ productType?: string; inStockOnly?: boolean; limit?: number }`"}},"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/liquiddeath/getProduct":{"post":{"operationId":"getProduct","summary":"Reads one product by its handle — every variant, its exact price and whether that specific size or colour is purchasable right now.","description":"Reads one product by its handle — every variant, its exact price and whether that specific size or colour is purchasable right now. Takes the handle searchProducts returns. THROWS on an unknown handle (the store answers a real 404), naming searchProducts as the way to find the right one.\n\nCalls `bowmark.providers.liquiddeath.getProduct`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<LiquiddeathProduct>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"handle":{"type":"string","description":"TypeScript: `string`"}},"required":["handle"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/liquiddeath/addToCart":{"post":{"operationId":"addToCart","summary":"Builds a filled Liquid Death cart for the shopper to open — give it handles and quantities, get back cartUrl (lands on the store's cart page with the lines in it) and checkoutUrl (straight to payment)","description":"Builds a filled Liquid Death cart for the shopper to open — give it handles and quantities, get back cartUrl (lands on the store's cart page with the lines in it) and checkoutUrl (straight to payment), priced against the store's live variants. Reads stock first and reports `available` per line, because the store itself accepts a sold-out variant into a cart link without complaint. Adds nothing to any cart here: the cart is created in the shopper's own session when they open the URL, and nothing is bought until they pay. THROWS on an unknown handle or a variantId that does not belong to it.\n\nCalls `bowmark.providers.liquiddeath.addToCart`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<LiquiddeathCart>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"items":{"type":"array","items":{"$ref":"#/components/schemas/LiquiddeathCartItem"},"description":"TypeScript: `LiquiddeathCartItem[]`"}},"required":["items"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}},"/v1/sites/liquiddeath/getCart":{"post":{"operationId":"getCart","summary":"Reads a cart the shopper already has, by its id — line items, quantities, per-unit and per-line prices, order subtotal and total, the cart's currency and expiry, and the real checkout URL to hand back","description":"Reads a cart the shopper already has, by its id — line items, quantities, per-unit and per-line prices, order subtotal and total, the cart's currency and expiry, and the real checkout URL to hand back. The id is a bearer credential the SHOPPER holds, and it is the one their cart or checkout LINK carries (liquiddeath.com/cart/c/<token>?key=<key>), NOT the store's `cart` cookie or /cart.js token — those are a separate Ajax id space this endpoint answers 'The requested cart does not exist' for. There is no way to list or search carts, so a caller without an id cannot get one. THE WHOLE id IS REQUIRED, `?key=` included: the store checks the key's value, so a bare token comes back as a cart that does not exist rather than as a missing credential, and this refuses it here instead. THROWS when the cart does not exist or has expired — Shopify drops an unused cart within 30 days and deletes it at checkout — because an empty cart and a dead link are opposite answers. Each line carries the store's own joined product-and-variant `title` (\"Death Western Hat - Cream/Green\"); this door publishes no separate product title. Does not return shipping options or discounts: both require setting an address on the cart, which is a write this provider does not perform.\n\nCalls `bowmark.providers.liquiddeath.getCart`. The body is the function's arguments, keyed by parameter name. `result` in the response is what it returns: `Promise<LiquiddeathLiveCart>`.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cartId":{"type":"string","description":"TypeScript: `string`"}},"required":["cartId"],"additionalProperties":false}}}},"responses":{"200":{"description":"The call ran. That includes a call that failed (`status: error`) or paused for a sign-in (`status: needs_user`), so branch on `status`.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/RunEnvelope"},{"type":"object","properties":{"result":{}}}]}}}},"400":{"description":"The body was malformed. `error` says what to send.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"401":{"description":"No API key, or a key that was refused.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"402":{"description":"The account is out of free usage, at its spend cap, or its card was declined. Fix billing at https://bowmark.ai/dashboard/billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}},"404":{"$ref":"#/components/responses/NotFound"},"429":{"description":"Too many runs in flight on this account. Nothing was started or charged.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}},"headers":{"Retry-After":{"schema":{"type":"integer"},"description":"Seconds to wait."}}},"503":{"description":"A failure on Bowmark's side. Retry.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}}}}},"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Your Bowmark API key."},"apiKeyHeader":{"type":"apiKey","in":"header","name":"X-Bowmark-Key"}},"responses":{"NotFound":{"description":"No such site or function.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEnvelope"}}}}},"schemas":{"RunEnvelope":{"type":"object","description":"What a run returns. `status` says whether the SCRIPT succeeded. A script that threw or paused for a login is still HTTP 200. Branch on `status`, not on the HTTP code.","required":["ok","status","result","logs","error","ms"],"properties":{"runId":{"type":"string","description":"Stable id for this run. Quote it in a support or `report` message."},"ok":{"type":"boolean","description":"False only when the run produced nothing usable."},"status":{"type":"string","enum":["ok","error","partial","needs_user"],"description":"`partial`: the result is real but some calls failed (see `incomplete`); `ok` stays true. `needs_user`: a person must sign in to a site first. Relay `meta.handoff.url` to them, then run again."},"egress":{"type":"string","enum":["default","link"],"description":"The egress the run was given, present only when the request asked for one. `link`: every request went through the caller's own Chrome (Bowmark Buddy)."},"result":{"description":"Whatever the script `return`ed. Any JSON value."},"logs":{"type":"array","items":{"type":"string"},"description":"Lines the script wrote with `log(...)`."},"error":{"type":["string","null"],"description":"Why the run failed, in plain words. Null on success."},"ms":{"type":"integer","description":"How long the script itself ran, in milliseconds."},"queuedMs":{"type":"integer","description":"How long the run waited for a worker before starting. Present only when it was a second or more."},"needs":{"type":"array","description":"The sign-ins this script is waiting on. Present when `status` is `needs_user`.","items":{"type":"object","required":["capability","provider","providerTitle","kind"],"properties":{"capability":{"type":"string"},"provider":{"type":"string"},"providerTitle":{"type":"string","description":"The site's name, to show a person."},"kind":{"type":"string"}}}},"incomplete":{"type":"object","description":"Present only when `status` is `partial`: which calls did not answer.","properties":{"summary":{"type":"string"},"totalCalls":{"type":"integer"}},"additionalProperties":true},"emptyHanded":{"type":"object","description":"Present when the script returned nothing while its calls returned rows, usually a filter that matched none of the site's own labels. Lists the label values the calls actually returned.","additionalProperties":true},"notes":{"type":"array","description":"Caveats a call attached to a complete answer. Never changes `status`.","items":{"type":"object","properties":{"path":{"type":"string"},"notes":{"type":"array","items":{"type":"string"}}}}},"meta":{"type":"object","properties":{"handoff":{"type":"object","description":"A single-use sign-in link for a person to open. Expires at `expiresAt`.","properties":{"ref":{"type":"string"},"url":{"type":"string","format":"uri"},"expiresAt":{"type":"string","format":"date-time"}}},"concurrency":{"type":"object","description":"On a 429: how many runs are in flight and when to retry.","properties":{"limit":{"type":"integer"},"inFlight":{"type":"integer"},"retryAfterSeconds":{"type":"integer"}}}},"additionalProperties":true},"notice":{"type":"object","description":"Set when the account owner has not accepted the current Terms. Relay it to them.","additionalProperties":true}}},"LiquiddeathCartItem":{"type":"object","properties":{"handle":{"type":"string"},"variantId":{"type":"string"},"variantTitle":{"type":"string"},"quantity":{"type":"number"}},"required":["handle"],"additionalProperties":true}}}}