# Bolder API

> Bolder API documentation.

## Docs

- [Bolder API](/docs): Bolder API documentation — v1 and v2.

## v1

- [Bolder API v1](/docs/v1): The Bolder API is a hypermedia-driven REST API following the HAL (Hypertext Application Language) specification.

### Root

- [Root endpoint](/docs/v1/root/get-root): Returns the authenticated user's account information and an embedded list of their shops, each… Reference for the GET / endpoint in the Bolder API v1.

### Shops

- [List shops](/docs/v1/shops/list-shops): Returns a paginated list of shops accessible to the authenticated account. Reference for the GET /shops endpoint in the Bolder API v1.
- [Shop details](/docs/v1/shops/get-shop): Returns full details for a single shop, including HAL links for all available actions… Reference for the GET /shops/{id} endpoint in the Bolder API v1.

### Products

- [List all products](/docs/v1/products/list-products): Returns a paginated list of products across all shops accessible to the token. Supports rich… Reference for the GET /products endpoint in the Bolder API v1.
- [Product details](/docs/v1/products/get-product): Returns full details for a single product including embedded variants, images,… Reference for the GET /products/{id} endpoint in the Bolder API v1.
- [Delete product](/docs/v1/products/delete-product): Permanently deletes a product and all its variants and images. Requires admin scope. Reference for the DELETE /products/{id} endpoint in the Bolder API v1.
- [Create product](/docs/v1/products/create-product): Creates a new product in the given shop. Requires admin scope. Reference for the POST /shops/{shop_id}/products endpoint in the Bolder API v1.
- [Update product](/docs/v1/products/update-product): Updates an existing product. All fields are optional — only supplied… Reference for the PUT /shops/{shop_id}/products/{id} endpoint in the Bolder API v1.

### Variants

- [Variant details](/docs/v1/variants/get-variant): Returns details for a single product variant. Reference for the GET /shops/{shop_id}/variants/{id} endpoint in the Bolder API v1.
- [Update variant](/docs/v1/variants/update-variant): Updates an existing variant. You can also look up the variant by sku… Reference for the PUT /shops/{shop_id}/variants/{id} endpoint in the Bolder API v1.
- [Delete variant](/docs/v1/variants/delete-variant): Removes a variant from its product. Requires admin scope. Reference for the DELETE /shops/{shop_id}/variants/{id} endpoint in the Bolder API v1.
- [Create variant](/docs/v1/variants/create-variant): Adds a new variant to an existing product. Requires admin scope. Reference for the POST /products/{product_id}/variants endpoint in the Bolder API v1.

### Product Images

- [Upload product image](/docs/v1/product-images/create-product-asset): Uploads a new image to a product. The image data must be Base64-encoded… Reference for the POST /products/{product_id}/assets endpoint in the Bolder API v1.
- [Delete product image](/docs/v1/product-images/delete-product-asset): Permanently removes an image from a product. Requires admin scope. Reference for the DELETE /products/{product_id}/assets/{id} endpoint in the Bolder API v1.

### Orders

- [List orders](/docs/v1/orders/list-orders): Returns a paginated list of orders for a shop. Requires admin scope. Supports… Reference for the GET /shops/{shop_id}/orders endpoint in the Bolder API v1.
- [Create order](/docs/v1/orders/create-order): Creates a new order in checkout state with the given line items, contact and… Reference for the POST /shops/{shop_id}/orders endpoint in the Bolder API v1.
- [Order details](/docs/v1/orders/get-order): Returns full details for a single order. Requires admin scope. Reference for the GET /shops/{shop_id}/orders/{code} endpoint in the Bolder API v1.
- [Update order](/docs/v1/orders/update-order): Updates an order that is in checkout state. Use this to set or modify… Reference for the PUT /shops/{shop_id}/orders/{code} endpoint in the Bolder API v1.
- [Batch update orders](/docs/v1/orders/batch-update-orders): Updates one or more order attributes across multiple orders at once.… Reference for the POST /shops/{shop_id}/orders/updaters endpoint in the Bolder API v1.

### Contacts

- [List shop contacts](/docs/v1/contacts/list-contacts): Returns a paginated list of contacts (customers) for a shop. Requires admin… Reference for the GET /shops/{shop_id}/contacts endpoint in the Bolder API v1.

### Webhooks

- [Webhooks hub](/docs/v1/webhooks/get-hub): Returns the webhooks hub for a shop, including HAL links to subscribe, unsubscribe and… Reference for the GET /hub/{shop_id} endpoint in the Bolder API v1.
- [List subscriptions](/docs/v1/webhooks/list-subscriptions): Returns a paginated list of webhook subscriptions for a shop. Reference for the GET /hub/{shop_id}/subscriptions endpoint in the Bolder API v1.
- [Subscribe](/docs/v1/webhooks/create-subscription): Creates a new webhook subscription. After creation the API sends a… Reference for the POST /hub/{shop_id}/subscriptions endpoint in the Bolder API v1.
- [Unsubscribe](/docs/v1/webhooks/delete-subscription): Deletes a webhook subscription. Reference for the DELETE /hub/{shop_id}/subscriptions/{id} endpoint in the Bolder API v1.

### Themes

- [Theme details](/docs/v1/themes/get-theme): Returns the active theme for a shop, including all templates and static assets.… Reference for the GET /shops/{shop_id}/theme endpoint in the Bolder API v1.
- [Update theme settings](/docs/v1/themes/update-theme): Updates the settings object for a theme. Requires admin scope. Reference for the PUT /themes/{id} endpoint in the Bolder API v1.
- [Create template](/docs/v1/themes/create-template): Adds a new HTML, CSS or JavaScript template to a theme. The file_name… Reference for the POST /themes/{theme_id}/templates endpoint in the Bolder API v1.
- [Update template](/docs/v1/themes/update-template): Updates the body of an existing theme template. Requires admin scope. Reference for the PUT /themes/{theme_id}/templates/{id} endpoint in the Bolder API v1.
- [Delete template](/docs/v1/themes/delete-template): Removes a template from a theme. Some core templates (e.g.… Reference for the DELETE /themes/{theme_id}/templates/{id} endpoint in the Bolder API v1.
- [Upload theme asset](/docs/v1/themes/create-theme-asset): Uploads a new static asset (image, font, etc.) to a theme. The file data must… Reference for the POST /themes/{theme_id}/assets endpoint in the Bolder API v1.
- [Delete theme asset](/docs/v1/themes/delete-theme-asset): Permanently removes a static asset from a theme. Requires admin scope. Reference for the DELETE /themes/{theme_id}/assets/{id} endpoint in the Bolder API v1.

## v2

- [Bolder API v2](/docs/v2): The Bolder API provides programmatic access to your Bolder Shop data through a hypermedia-driven REST interface.

### Root

- [API root](/docs/v2/root/get-root): Returns the API entry point. Embeds the authenticated account's shops and provides navigation links… Reference for the GET / endpoint in the Bolder API v2.

### Sellers

- [List sellers](/docs/v2/sellers/list-sellers): Returns all sellers belonging to the authenticated account. Results are automatically scoped to… Reference for the GET /sellers endpoint in the Bolder API v2.
- [Get a seller](/docs/v2/sellers/get-seller): Returns a single seller by ID. Sellers are account-scoped. Reference for the GET /sellers/{id} endpoint in the Bolder API v2.

### Shops

- [List events](/docs/v2/shops/list-events-flattened): Returns events across the account. Optionally filter by shop_id or seller_id query parameter. Reference for the GET /events endpoint in the Bolder API v2.
- [List exchange rates](/docs/v2/shops/list-exchange-rates-flattened): Returns exchange rates across the account. Optionally filter by shop_id or seller_id… Reference for the GET /exchange_rates endpoint in the Bolder API v2.
- [List payment methods](/docs/v2/shops/list-payment-methods-flattened): Returns payment methods across the account. Optionally filter by shop_id or seller_id… Reference for the GET /payment_methods endpoint in the Bolder API v2.
- [List shipping tables](/docs/v2/shops/list-shipping-tables-flattened): Returns shipping tables across the account. Optionally filter by shop_id or seller_id… Reference for the GET /shipping_tables endpoint in the Bolder API v2.
- [Get a shipping table](/docs/v2/shops/get-shipping-table-flattened): Get a shipping table. Reference for the GET /shipping_tables/{id} endpoint in the Bolder API v2.
- [List shops](/docs/v2/shops/list-shops): Returns shops belonging to the authenticated account. Reference for the GET /shops endpoint in the Bolder API v2.
- [Get a shop](/docs/v2/shops/get-shop): Get a shop. Reference for the GET /shops/{id} endpoint in the Bolder API v2.
- [Get shop settings](/docs/v2/shops/get-shop-settings): Get shop settings. Reference for the GET /shops/{id}/settings endpoint in the Bolder API v2.
- [List shop admins](/docs/v2/shops/list-shop-admins): Returns admin users for the given shop. Reference for the GET /shops/{shop_id}/admins endpoint in the Bolder API v2.
- [Get a shop admin](/docs/v2/shops/get-shop-admin): Get a shop admin. Reference for the GET /shops/{shop_id}/admins/{id} endpoint in the Bolder API v2.
- [List shop events](/docs/v2/shops/list-shop-events): Returns the event log for this shop (webhook delivery history, order events, etc). Reference for the GET /shops/{shop_id}/events endpoint in the Bolder API v2.
- [List payment methods for a shop](/docs/v2/shops/list-payment-methods): Returns the payment methods configured for the shop. Reference for the GET /shops/{shop_id}/payment_methods endpoint in the Bolder API v2.
- [List exchange rates for a shop](/docs/v2/shops/list-exchange-rates): Returns current USD exchange rates for supported currencies. Reference for the GET /shops/{shop_id}/exchange_rates endpoint in the Bolder API v2.
- [List order tags](/docs/v2/shops/list-order-tags): Returns all tags currently applied to orders in this shop. Reference for the GET /shops/{shop_id}/order_tags endpoint in the Bolder API v2.
- [List shipping tables for a shop](/docs/v2/shops/list-shipping-tables): Returns shipping tables configured for the shop, with their shipping… Reference for the GET /shops/{shop_id}/shipping_tables endpoint in the Bolder API v2.
- [Get a shipping table for a shop](/docs/v2/shops/get-shipping-table): Get a shipping table for a shop. Reference for the GET /shops/{shop_id}/shipping_tables/{id} endpoint in the Bolder API v2.

### Content

- [List shop posts](/docs/v2/content/list-shop-posts): Returns blog/news posts for the shop. Reference for the GET /shops/{shop_id}/posts endpoint in the Bolder API v2.
- [Create a post](/docs/v2/content/create-post): Creates a post in the shop's default blog, or in the blog given by blog_id (see… Reference for the POST /shops/{shop_id}/posts endpoint in the Bolder API v2.
- [Get a post](/docs/v2/content/get-post): Get a post. Reference for the GET /posts/{id} endpoint in the Bolder API v2.
- [Update a post](/docs/v2/content/update-post): Update a post. Reference for the PUT /posts/{id} endpoint in the Bolder API v2.
- [Delete a post](/docs/v2/content/delete-post): Delete a post. Reference for the DELETE /posts/{id} endpoint in the Bolder API v2.
- [List shop blogs](/docs/v2/content/list-shop-blogs): Returns the shop's blogs. A shop can have several, each with its own language;… Reference for the GET /shops/{shop_id}/blogs endpoint in the Bolder API v2.
- [Get a blog](/docs/v2/content/get-blog): Get a blog. Reference for the GET /blogs/{id} endpoint in the Bolder API v2.
- [List pages](/docs/v2/content/list-shop-pages): Returns static content pages for the shop. Reference for the GET /shops/{shop_id}/pages endpoint in the Bolder API v2.
- [Create a page](/docs/v2/content/create-page): Create a page. Reference for the POST /shops/{shop_id}/pages endpoint in the Bolder API v2.
- [Get a page](/docs/v2/content/get-page): Get a page. Reference for the GET /pages/{id} endpoint in the Bolder API v2.
- [Update a page](/docs/v2/content/update-page): Update a page. Reference for the PUT /pages/{id} endpoint in the Bolder API v2.
- [Delete a page](/docs/v2/content/delete-page): Delete a page. Reference for the DELETE /pages/{id} endpoint in the Bolder API v2.
- [List forms](/docs/v2/content/list-shop-forms): Returns contact/lead-capture forms for the shop. Reference for the GET /shops/{shop_id}/forms endpoint in the Bolder API v2.
- [Create a form](/docs/v2/content/create-form): Create a form. Reference for the POST /shops/{shop_id}/forms endpoint in the Bolder API v2.
- [Get a form](/docs/v2/content/get-form): Get a form. Reference for the GET /forms/{id} endpoint in the Bolder API v2.
- [Update a form](/docs/v2/content/update-form): Update a form. Reference for the PUT /forms/{id} endpoint in the Bolder API v2.
- [Delete a form](/docs/v2/content/delete-form): Delete a form. Reference for the DELETE /forms/{id} endpoint in the Bolder API v2.

### Products

- [List product tags](/docs/v2/products/list-product-tags-flattened): Returns product tags across the account. Optionally filter by shop_id or seller_id query… Reference for the GET /product_tags endpoint in the Bolder API v2.
- [List products](/docs/v2/products/list-products): Returns products scoped to the authenticated account. Reference for the GET /products endpoint in the Bolder API v2.
- [Create a product](/docs/v2/products/create-product): Creates a product in the specified shop. shop_id must be a shop belonging to the… Reference for the POST /products endpoint in the Bolder API v2.
- [Batch update products](/docs/v2/products/batch-update-products): Updates multiple existing products in a single request (does not create new ones).… Reference for the POST /products/updaters endpoint in the Bolder API v2.
- [Get a product](/docs/v2/products/get-product): Get a product. Reference for the GET /products/{id} endpoint in the Bolder API v2.
- [Update a product](/docs/v2/products/update-product): Updates the product. If a product with the given ID/slug does not exist and dont_create… Reference for the PUT /products/{id} endpoint in the Bolder API v2.
- [Delete a product](/docs/v2/products/delete-product): Delete a product. Reference for the DELETE /products/{id} endpoint in the Bolder API v2.
- [List product price items](/docs/v2/products/get-product-price-items): Returns price items for a specific product. Reference for the GET /products/{id}/price_items endpoint in the Bolder API v2.
- [Create a product asset](/docs/v2/products/create-product-asset): Create a product asset. Reference for the POST /products/{product_id}/assets endpoint in the Bolder API v2.
- [Delete a product asset](/docs/v2/products/delete-product-asset): Delete a product asset. Reference for the DELETE /products/{product_id}/assets/{id} endpoint in the Bolder API v2.
- [Create a product relation](/docs/v2/products/create-product-relation): Create a product relation. Reference for the POST /products/{product_id}/relations endpoint in the Bolder API v2.
- [List product tags for a shop](/docs/v2/products/list-product-tags): Returns all tags currently applied to products in this shop. Reference for the GET /shops/{shop_id}/product_tags endpoint in the Bolder API v2.
- [List vendors](/docs/v2/products/list-shop-vendors): Returns all vendor names present in the shop's product catalog. Reference for the GET /shops/{shop_id}/vendors endpoint in the Bolder API v2.
- [List custom product attributes](/docs/v2/products/list-custom-product-attributes): Returns all unique custom attribute names used across… Reference for the GET /shops/{shop_id}/custom_product_attributes endpoint in the Bolder API v2.
- [List product sets](/docs/v2/products/list-shop-product-sets): Returns product sets (dynamic rule-based groupings) for the shop. Reference for the GET /shops/{shop_id}/product_sets endpoint in the Bolder API v2.

### Variants

- [List variants](/docs/v2/variants/list-variants): Returns variants for a product. Reference for the GET /products/{product_id}/variants endpoint in the Bolder API v2.
- [Create a variant](/docs/v2/variants/create-variant): Creates a new variant for a product. Reference for the POST /products/{product_id}/variants endpoint in the Bolder API v2.
- [Get a variant](/docs/v2/variants/get-variant): Get a variant. Reference for the GET /products/{product_id}/variants/{id} endpoint in the Bolder API v2.
- [Update a variant](/docs/v2/variants/update-variant): Variant names are set via option1/option2/option3. On update,… Reference for the PUT /products/{product_id}/variants/{id} endpoint in the Bolder API v2.
- [Delete a variant](/docs/v2/variants/delete-variant): Delete a variant. Reference for the DELETE /products/{product_id}/variants/{id} endpoint in the Bolder API v2.
- [Batch update variants](/docs/v2/variants/batch-update-variants): Updates multiple existing variants in a single request (does… Reference for the POST /products/{product_id}/variants/updaters endpoint in the Bolder API v2.

### Price Lists

- [List price lists](/docs/v2/price-lists/list-price-lists): Returns price lists for the authenticated account. A price list lets you override variant… Reference for the GET /price_lists endpoint in the Bolder API v2.
- [Create a price list](/docs/v2/price-lists/create-price-list): Create a price list. Reference for the POST /price_lists endpoint in the Bolder API v2.
- [Get a price list](/docs/v2/price-lists/get-price-list): Get a price list. Reference for the GET /price_lists/{id} endpoint in the Bolder API v2.
- [Update a price list](/docs/v2/price-lists/update-price-list): Update a price list. Reference for the PUT /price_lists/{id} endpoint in the Bolder API v2.
- [Delete a price list](/docs/v2/price-lists/delete-price-list): Delete a price list. Reference for the DELETE /price_lists/{id} endpoint in the Bolder API v2.
- [List products in a price list](/docs/v2/price-lists/get-price-list-products): Returns all products that have a price override within this price list. Reference for the GET /price_lists/{id}/products endpoint in the Bolder API v2.
- [List price items](/docs/v2/price-lists/list-price-items): Returns all price item overrides within the given price list. Reference for the GET /price_lists/{price_list_id}/items endpoint in the Bolder API v2.
- [Update a price item](/docs/v2/price-lists/update-price-item): Set or update the price override for a variant in this price list. Reference for the PUT /price_lists/{price_list_id}/items/{id} endpoint in the Bolder API v2.
- [Delete a price item](/docs/v2/price-lists/delete-price-item): Remove the price override for this variant from the price list. Reference for the DELETE /price_lists/{price_list_id}/items/{id} endpoint in the Bolder API v2.

### Product Types

- [List product types](/docs/v2/product-types/list-product-types): Returns product types for a shop. shop_id is required. Reference for the GET /product_types endpoint in the Bolder API v2.
- [Create a product type](/docs/v2/product-types/create-product-type): Create a product type. Reference for the POST /product_types endpoint in the Bolder API v2.
- [Update or upsert a product type](/docs/v2/product-types/update-product-type): If no product type with this id exists for the account's seller, one is created… Reference for the PUT /product_types/{id} endpoint in the Bolder API v2.

### Collections

- [List collections](/docs/v2/collections/list-collections): Returns collections for a shop. shop_id is required. Reference for the GET /collections endpoint in the Bolder API v2.
- [Get a collection](/docs/v2/collections/get-collections-id): Get a collection. Reference for the GET /collections/{id} endpoint in the Bolder API v2.
- [Delete a collection](/docs/v2/collections/delete-collection): Requires products.write scope on the collection's seller. Reference for the DELETE /collections/{id} endpoint in the Bolder API v2.

### Orders

- [List order tags](/docs/v2/orders/list-order-tags-flattened): Returns order tags across the account. Optionally filter by shop_id or seller_id query… Reference for the GET /order_tags endpoint in the Bolder API v2.
- [List orders](/docs/v2/orders/list-orders): Returns orders for a shop, or for a whole seller across all of its shops. Reference for the GET /orders endpoint in the Bolder API v2.
- [Create an order](/docs/v2/orders/create-order): Creates an order. There is no Idempotency-Key-header-style replay mechanism — a retried request… Reference for the POST /orders endpoint in the Bolder API v2.
- [Batch update orders](/docs/v2/orders/batch-update-orders): Batch update multiple orders in a single request. additions accepts order fields (e.g.… Reference for the POST /orders/updaters endpoint in the Bolder API v2.
- [Get an order](/docs/v2/orders/get-order): Direct access to an order by ID or permalink. No shop_id needed in the URL — authorization… Reference for the GET /orders/{id} endpoint in the Bolder API v2.
- [Update an order](/docs/v2/orders/update-order): Setting status to most values requires _policies.allow_status: true in the request body. Reference for the PUT /orders/{id} endpoint in the Bolder API v2.
- [Refund an order](/docs/v2/orders/refund-order): Refund an order. Reference for the POST /orders/{id}/refund endpoint in the Bolder API v2.
- [Split an order](/docs/v2/orders/split-order): Splits a subset of line items (in full or partial quantity) off the original order… Reference for the POST /orders/{id}/split endpoint in the Bolder API v2.
- [List order documents](/docs/v2/orders/list-order-documents): List order documents. Reference for the GET /orders/{order_id}/documents endpoint in the Bolder API v2.
- [Create an order document](/docs/v2/orders/create-order-document): Create an order document. Reference for the POST /orders/{order_id}/documents endpoint in the Bolder API v2.
- [Get an order document](/docs/v2/orders/get-order-document): Get an order document. Reference for the GET /orders/{order_id}/documents/{id} endpoint in the Bolder API v2.
- [Delete an order document](/docs/v2/orders/delete-order-document): Delete an order document. Reference for the DELETE /orders/{order_id}/documents/{id} endpoint in the Bolder API v2.
- [Add a line item to an order](/docs/v2/orders/create-order-item): Adds a single item to the order. Accepts the same fields as one element of the… Reference for the POST /orders/{order_id}/items endpoint in the Bolder API v2.
- [Update an order line item](/docs/v2/orders/update-order-item): Updates units and/or price on an existing line item. Order totals are… Reference for the PUT /orders/{order_id}/items/{id} endpoint in the Bolder API v2.
- [Remove a line item from an order](/docs/v2/orders/delete-order-item): Returns the updated order (200), not 204, so the caller sees the new… Reference for the DELETE /orders/{order_id}/items/{id} endpoint in the Bolder API v2.
- [Record a manual payment on an order](/docs/v2/orders/create-order-payment): Records a manual payment (cash, bank transfer, external processor, etc.)… Reference for the POST /orders/{order_id}/payments endpoint in the Bolder API v2.
- [Start (or resume) checkout for an order](/docs/v2/orders/create-checkout-session): Starts, or returns the existing active, checkout session for an… Reference for the POST /orders/{order_id}/checkout_session endpoint in the Bolder API v2.
- [Get a checkout session](/docs/v2/orders/get-checkout-session): Resolves a checkout session by its token. Does not auto-rotate an expired… Reference for the GET /checkout_sessions/{id} endpoint in the Bolder API v2.
- [Mark a checkout session as viewed](/docs/v2/orders/view-checkout-session): Records last_viewed_at/view_count. Not a "checkout complete" signal —… Reference for the POST /checkout_sessions/{id}/view endpoint in the Bolder API v2.

### Customers

- [List customer tags](/docs/v2/customers/list-customer-tags): Returns customer tags across the account. Optionally filter by shop_id or seller_id query… Reference for the GET /customer_tags endpoint in the Bolder API v2.
- [List customer tags for a shop](/docs/v2/customers/list-contact-tags): Returns all tags currently applied to customers in this shop. Reference for the GET /shops/{shop_id}/customer_tags endpoint in the Bolder API v2.
- [List contact groups (flat)](/docs/v2/customers/list-contact-groups-flat): Returns customer groups (segments). Optionally filter by shop_id or seller_id; without… Reference for the GET /contact_groups endpoint in the Bolder API v2.
- [Create a contact group (flat)](/docs/v2/customers/create-contact-group-flat): seller_id is required in the body. Reference for the POST /contact_groups endpoint in the Bolder API v2.
- [List contact groups (legacy shop-nested)](/docs/v2/customers/list-contact-groups): Returns customer groups (segments) for the shop. Reference for the GET /shops/{shop_id}/customer_groups endpoint in the Bolder API v2.
- [Create a contact group (legacy shop-nested)](/docs/v2/customers/create-contact-group): Creates a customer group for the shop. Reference for the POST /shops/{shop_id}/customer_groups endpoint in the Bolder API v2.
- [Get a contact group](/docs/v2/customers/get-contact-group): Get a contact group. Reference for the GET /contact_groups/{id} endpoint in the Bolder API v2.
- [Update a contact group](/docs/v2/customers/update-contact-group): Update a contact group. Reference for the PUT /contact_groups/{id} endpoint in the Bolder API v2.
- [Delete a contact group](/docs/v2/customers/delete-contact-group): Delete a contact group. Reference for the DELETE /contact_groups/{id} endpoint in the Bolder API v2.
- [List contacts in a group](/docs/v2/customers/list-contact-group-contacts): Returns all contacts belonging to this contact group. Reference for the GET /contact_groups/{id}/contacts endpoint in the Bolder API v2.
- [List customers](/docs/v2/customers/list-customers): Returns customers for a shop, or for a whole seller across all of its shops. Reference for the GET /customers endpoint in the Bolder API v2.
- [Create a customer](/docs/v2/customers/create-customer): If a contact with the given email already exists for this shop, it is updated rather than… Reference for the POST /customers endpoint in the Bolder API v2.
- [Get a customer](/docs/v2/customers/get-customer): Get a customer. Reference for the GET /customers/{id} endpoint in the Bolder API v2.
- [Update a customer](/docs/v2/customers/update-customer): Update a customer. Reference for the PUT /customers/{id} endpoint in the Bolder API v2.
- [Get last ordered products](/docs/v2/customers/get-customer-last-ordered-products): Get last ordered products. Reference for the GET /customers/{id}/last_ordered_products endpoint in the Bolder API v2.
- [Start contact activation](/docs/v2/customers/start-contact-activation): Start contact activation. Reference for the POST /customers/{id}/activations endpoint in the Bolder API v2.
- [Start phone validation](/docs/v2/customers/start-phone-validation): Start phone validation. Reference for the POST /customers/{id}/phone_validations endpoint in the Bolder API v2.
- [Demote a contact](/docs/v2/customers/demote-contact): Demote a contact. Reference for the DELETE /customers/{id}/activation endpoint in the Bolder API v2.
- [Authenticate a customer](/docs/v2/customers/authenticate-customer): Validates email + password credentials for a shop's customer account. Returns the… Reference for the POST /customers/sessions endpoint in the Bolder API v2.
- [Request a password reset](/docs/v2/customers/reset-customer-password): Sends a password-reset email to the customer's address. Returns 200 even if… Reference for the POST /customers/reset_password endpoint in the Bolder API v2.
- [Activate a customer account](/docs/v2/customers/activate-customer): Completes the customer account activation flow by setting the initial… Reference for the PUT /customers/activations/{token} endpoint in the Bolder API v2.

### Promotions

- [List promotions](/docs/v2/promotions/list-promotions): Returns discount promotions. Promotions apply percentage or fixed-amount discounts via… Reference for the GET /promotions endpoint in the Bolder API v2.
- [Create a promotion](/docs/v2/promotions/create-promotion): Creates a new promotion for a shop. Promotions apply percentage or fixed-amount discounts… Reference for the POST /promotions endpoint in the Bolder API v2.
- [Get a promotion](/docs/v2/promotions/get-promotion): Returns a single promotion by ID. Reference for the GET /promotions/{id} endpoint in the Bolder API v2.
- [Update a promotion](/docs/v2/promotions/update-promotion): Updates an existing promotion. Reference for the PUT /promotions/{id} endpoint in the Bolder API v2.
- [Delete a promotion](/docs/v2/promotions/delete-promotion): Soft-deletes a promotion. Reference for the DELETE /promotions/{id} endpoint in the Bolder API v2.

### Volume Discounts

- [List volume discounts](/docs/v2/volume-discounts/list-volume-discounts): Returns volume discount rules. Volume discounts automatically apply tiered pricing… Reference for the GET /volume_discounts endpoint in the Bolder API v2.
- [Create a volume discount](/docs/v2/volume-discounts/create-volume-discount): Creates a new volume discount for a shop. Volume discounts automatically apply tiered… Reference for the POST /volume_discounts endpoint in the Bolder API v2.
- [Get a volume discount](/docs/v2/volume-discounts/get-volume-discount): Returns a single volume discount by ID. Reference for the GET /volume_discounts/{id} endpoint in the Bolder API v2.
- [Update a volume discount](/docs/v2/volume-discounts/update-volume-discount): Updates an existing volume discount. Reference for the PUT /volume_discounts/{id} endpoint in the Bolder API v2.
- [Delete a volume discount](/docs/v2/volume-discounts/delete-volume-discount): Soft-deletes a volume discount. Reference for the DELETE /volume_discounts/{id} endpoint in the Bolder API v2.

### Themes

- [List themes for a shop](/docs/v2/themes/list-shop-themes): Returns the theme navigation document for the shop — links to the current production… Reference for the GET /shops/{id}/themes endpoint in the Bolder API v2.
- [Create a dev theme](/docs/v2/themes/create-shop-theme): Creates a new development theme by cloning the current production theme. If a dev… Reference for the POST /shops/{id}/themes endpoint in the Bolder API v2.
- [Get a theme](/docs/v2/themes/get-theme): Returns the full theme entity including all embedded templates and assets. The production… Reference for the GET /themes/{id} endpoint in the Bolder API v2.
- [Update a theme](/docs/v2/themes/update-theme): Update theme settings or title. Reference for the PUT /themes/{id} endpoint in the Bolder API v2.
- [Delete a dev theme](/docs/v2/themes/delete-theme): Deletes the dev theme. The production theme cannot be deleted. The store:delete_theme… Reference for the DELETE /themes/{id} endpoint in the Bolder API v2.
- [Publish a dev theme](/docs/v2/themes/publish-theme): Promotes the dev theme to production. The current production theme is archived… Reference for the PUT /themes/{id}/publication endpoint in the Bolder API v2.
- [Create a template](/docs/v2/themes/create-template): Creates a new template file inside the theme. The file_name determines the… Reference for the POST /themes/{theme_id}/templates endpoint in the Bolder API v2.
- [Update theme settings](/docs/v2/themes/update-theme-settings): Replaces the theme's global settings. Reference for the PUT /themes/{theme_id}/templates/settings endpoint in the Bolder API v2.
- [Get a template](/docs/v2/themes/get-template): Returns a single template including its full body source. Reference for the GET /themes/{theme_id}/templates/{id} endpoint in the Bolder API v2.
- [Update a template](/docs/v2/themes/update-template): Replace the body of an existing template. Reference for the PUT /themes/{theme_id}/templates/{id} endpoint in the Bolder API v2.
- [Delete a template](/docs/v2/themes/delete-template): Deletes a non-required template from the theme. Required templates… Reference for the DELETE /themes/{theme_id}/templates/{id} endpoint in the Bolder API v2.
- [Upload a theme asset](/docs/v2/themes/create-theme-asset): Uploads a new file asset (image, font, stylesheet, etc.) to the theme. Send… Reference for the POST /themes/{theme_id}/assets endpoint in the Bolder API v2.
- [Delete a theme asset](/docs/v2/themes/delete-theme-asset): Permanently deletes an asset from the theme. The… Reference for the DELETE /themes/{theme_id}/assets/{id} endpoint in the Bolder API v2.

### Webhooks

- [List webhooks](/docs/v2/webhooks/list-webhooks-flattened): Returns webhooks across the account. Optionally filter by shop_id or seller_id query parameter. Reference for the GET /webhooks endpoint in the Bolder API v2.
- [Create a webhook](/docs/v2/webhooks/create-webhook-flattened): shop_id is required when creating via this flat endpoint. Alternatively, use POST… Reference for the POST /webhooks endpoint in the Bolder API v2.
- [Get a webhook](/docs/v2/webhooks/get-webhook-flattened): Get a webhook. Reference for the GET /webhooks/{id} endpoint in the Bolder API v2.
- [Delete a webhook](/docs/v2/webhooks/delete-webhook-flattened): Delete a webhook. Reference for the DELETE /webhooks/{id} endpoint in the Bolder API v2.
- [Reactivate a failed webhook](/docs/v2/webhooks/reactivate-webhook-flattened): Reactivate a failed webhook. Reference for the PUT /webhooks/{id}/reactivate endpoint in the Bolder API v2.
- [Get webhook delivery history](/docs/v2/webhooks/webhook-history-flattened): Get webhook delivery history. Reference for the GET /webhooks/{id}/history endpoint in the Bolder API v2.
- [List webhooks for a seller](/docs/v2/webhooks/list-seller-webhooks): Seller-nested equivalent of GET /webhooks?seller_id=X. Reference for the GET /sellers/{seller_id}/webhooks endpoint in the Bolder API v2.
- [Create a webhook for a seller](/docs/v2/webhooks/create-seller-webhook): Create a webhook for a seller. Reference for the POST /sellers/{seller_id}/webhooks endpoint in the Bolder API v2.

### Subscriptions

- [List subscription purchases](/docs/v2/subscriptions/list-subscription-purchases): Returns customer subscriptions. Reference for the GET /subscription_purchases endpoint in the Bolder API v2.
- [Get a subscription purchase](/docs/v2/subscriptions/get-subscription-purchase): Get a subscription purchase. Reference for the GET /subscription_purchases/{id} endpoint in the Bolder API v2.
- [Update a subscription purchase](/docs/v2/subscriptions/update-subscription-purchase): Only the fields listed below are writable. Reference for the PUT /subscription_purchases/{id} endpoint in the Bolder API v2.
- [Record a manual renewal](/docs/v2/subscriptions/renew-subscription-purchase): Advances last_payment_on/next_payment_on and sets state back to… Reference for the PUT /subscription_purchases/{id}/renew endpoint in the Bolder API v2.
- [List subscription fees](/docs/v2/subscriptions/list-subscription-fees): List subscription fees. Reference for the GET /subscription_fees endpoint in the Bolder API v2.
- [Create a subscription fee](/docs/v2/subscriptions/create-subscription-fee): Attaches recurring-payment terms to a product (and optionally a specific variant). Reference for the POST /subscription_fees endpoint in the Bolder API v2.
- [Get a subscription fee](/docs/v2/subscriptions/get-subscription-fee): Get a subscription fee. Reference for the GET /subscription_fees/{id} endpoint in the Bolder API v2.
- [Update a subscription fee](/docs/v2/subscriptions/update-subscription-fee): Update a subscription fee. Reference for the PUT /subscription_fees/{id} endpoint in the Bolder API v2.
- [Delete a subscription fee](/docs/v2/subscriptions/delete-subscription-fee): Delete a subscription fee. Reference for the DELETE /subscription_fees/{id} endpoint in the Bolder API v2.

### Wallets

- [List wallet programs](/docs/v2/wallets/list-wallet-programs): A seller has at most one active PointsProgram and one active CreditProgram. Each… Reference for the GET /wallet_programs endpoint in the Bolder API v2.
- [Get a wallet program](/docs/v2/wallets/get-wallet-program): Get a wallet program. Reference for the GET /wallet_programs/{id} endpoint in the Bolder API v2.
- [Update a wallet program's settings](/docs/v2/wallets/update-wallet-program): Only the fields matching the program's own type are applied — points_* fields for… Reference for the PUT /wallet_programs/{id} endpoint in the Bolder API v2.
- [List wallets](/docs/v2/wallets/list-wallets): List wallets. Reference for the GET /wallets endpoint in the Bolder API v2.
- [Create (or find) a wallet for a contact](/docs/v2/wallets/create-wallet): Idempotent per contact + program: if a wallet already exists for this contact and program, the… Reference for the POST /wallets endpoint in the Bolder API v2.
- [Get a wallet](/docs/v2/wallets/get-wallet): Get a wallet. Reference for the GET /wallets/{id} endpoint in the Bolder API v2.
- [List transfers for a wallet](/docs/v2/wallets/list-wallet-transfers): List transfers for a wallet. Reference for the GET /wallets/{wallet_id}/transfers endpoint in the Bolder API v2.
- [Add a balance or payment transfer](/docs/v2/wallets/add-wallet-transfer): Creates a completed incoming transfer by default — used both for adding… Reference for the POST /wallets/{wallet_id}/transfers endpoint in the Bolder API v2.
- [Register points earned from a completed purchase](/docs/v2/wallets/register-wallet-purchase): Points wallets only. Reference for the POST /wallets/{id}/register_purchase endpoint in the Bolder API v2.
- [Reverse points earned from a purchase (e.g. on order cancellation)](/docs/v2/wallets/unregister-wallet-purchase): Points wallets only. Reverses the earning transfer outright when the… Reference for the POST /wallets/{id}/unregister_purchase endpoint in the Bolder API v2.

### Catalog

- [List vendors](/docs/v2/catalog/list-vendors): Returns vendors across the account. Optionally filter by shop_id or seller_id query parameter. Reference for the GET /vendors endpoint in the Bolder API v2.
- [List product sets](/docs/v2/catalog/list-product-sets): Returns product sets across the account. Optionally filter by shop_id or seller_id query… Reference for the GET /product_sets endpoint in the Bolder API v2.
- [List product groups](/docs/v2/catalog/list-product-groups): Returns aggregated product groups (collections, product types, vendors, tags) — a… Reference for the GET /product_groups endpoint in the Bolder API v2.

### Store

- [List themes](/docs/v2/store/list-themes-flattened): Returns themes across the account. Reference for the GET /themes endpoint in the Bolder API v2.

## Agent resources

- [llms-full.txt](/docs/llms-full.txt): The full Markdown of every page in one file.
- [Page Markdown](/docs/index.md): Append `.md` to any page URL to fetch that page as raw Markdown.
- [JSON API](/docs/api/docs/pages.json): Page index of the JSON docs API; each entry links the page's JSON and Markdown forms. Described by the OpenAPI document at /docs/openapi.json.
- [API catalog](/docs/.well-known/api-catalog): RFC 9727 linkset of the APIs documented here.
- [agent-readability.json](/docs/agent-readability.json): Manifest of every agent-facing artifact on this site.