# Vellaro

> Il motore e-commerce API-first. Costruisci il tuo storefront, la tua app mobile e le tue automazioni AI su Vellaro.

## Docs

- [AI & MCP](https://docs.vellaro.io/ai-mcp.md): Usa Vellaro come connettore per i motori AI tramite Model Context Protocol.
- [Account Summary](https://docs.vellaro.io/api-reference/account/account-summary.md): Aggregated dashboard figures for the authenticated customer.
- [My Affiliate](https://docs.vellaro.io/api-reference/account:affiliate/my-affiliate.md): The logged-in user's own affiliate record + earnings (null if not one).
- [List My Downloads](https://docs.vellaro.io/api-reference/account:downloads/list-my-downloads.md): The buyer's active download grants (newest first).
- [Cancel My Subscription](https://docs.vellaro.io/api-reference/account:subscriptions/cancel-my-subscription.md)
- [List My Subscriptions](https://docs.vellaro.io/api-reference/account:subscriptions/list-my-subscriptions.md)
- [Pause My Subscription](https://docs.vellaro.io/api-reference/account:subscriptions/pause-my-subscription.md)
- [Resume My Subscription](https://docs.vellaro.io/api-reference/account:subscriptions/resume-my-subscription.md)
- [Create Address](https://docs.vellaro.io/api-reference/addresses/create-address.md): Create a new address for the current user.
- [Delete Address](https://docs.vellaro.io/api-reference/addresses/delete-address.md): Delete an address (must belong to current user).
- [List Addresses](https://docs.vellaro.io/api-reference/addresses/list-addresses.md): Return all addresses for the current user.
- [Set Default Address](https://docs.vellaro.io/api-reference/addresses/set-default-address.md): Set an address as default for its type.
- [Update Address](https://docs.vellaro.io/api-reference/addresses/update-address.md): Update an existing address (must belong to current user).
- [Add Customer Reward](https://docs.vellaro.io/api-reference/admin/add-customer-reward.md): Admin: add reward points for a customer.
- [Add Customer Transaction](https://docs.vellaro.io/api-reference/admin/add-customer-transaction.md): Admin: add a monetary transaction for a customer.
- [Add Order Note](https://docs.vellaro.io/api-reference/admin/add-order-note.md): Admin: add a note to the order timeline. Internal notes are staff-only (never emailed, hidden from the customer-facing timeline).
- [Add Product Image](https://docs.vellaro.io/api-reference/admin/add-product-image.md): Admin: add image to product.
- [Admin Create User](https://docs.vellaro.io/api-reference/admin/admin-create-user.md): Admin: create a new user (typically an admin staff account) in this tenant.
- [Admin Deactivate User](https://docs.vellaro.io/api-reference/admin/admin-deactivate-user.md): Admin: soft-delete (deactivate) a user account.
- [Admin Disable User 2Fa](https://docs.vellaro.io/api-reference/admin/admin-disable-user-2fa.md): Admin: reset (disable) a user's two-factor authentication.
- [Admin Get Product](https://docs.vellaro.io/api-reference/admin/admin-get-product.md): Admin: full product detail by id.
- [Admin Get User](https://docs.vellaro.io/api-reference/admin/admin-get-user.md)
- [Admin List Brands](https://docs.vellaro.io/api-reference/admin/admin-list-brands.md): Admin: list all brands (including inactive).
- [Admin List Categories](https://docs.vellaro.io/api-reference/admin/admin-list-categories.md): Admin category listing — NOT the public /categories endpoint.
- [Admin List Orders](https://docs.vellaro.io/api-reference/admin/admin-list-orders.md): Admin: paginated list of all orders.
- [Admin List Products](https://docs.vellaro.io/api-reference/admin/admin-list-products.md): Admin paginated product listing.
- [Admin List Users](https://docs.vellaro.io/api-reference/admin/admin-list-users.md): Admin: paginated list of this tenant's users (staff + customers).
- [Admin Pending Orders Count](https://docs.vellaro.io/api-reference/admin/admin-pending-orders-count.md): Count of NEW orders needing attention (status = pending) — powers the sidebar badge. A single COUNT, cheap enough to poll every minute. An order leaves this count as soon as the operator moves it to `processing`.
- [Admin Update Order Fiscal](https://docs.vellaro.io/api-reference/admin/admin-update-order-fiscal.md): Admin: update customer fiscal data (P.IVA + Cod. Fisc.) used on the invoice.
- [Admin Update Order Status](https://docs.vellaro.io/api-reference/admin/admin-update-order-status.md): Admin: update order status, optionally add tracking info and a history comment.
- [Admin Update Payment Status](https://docs.vellaro.io/api-reference/admin/admin-update-payment-status.md): Admin: manually set payment_status (paid / failed / pending).
- [Admin Update User](https://docs.vellaro.io/api-reference/admin/admin-update-user.md): Admin: update user role / status / name / password.
- [Create Attribute](https://docs.vellaro.io/api-reference/admin/create-attribute.md)
- [Create Attribute Group](https://docs.vellaro.io/api-reference/admin/create-attribute-group.md)
- [Create Brand](https://docs.vellaro.io/api-reference/admin/create-brand.md): Admin: create a new brand.
- [Create Category](https://docs.vellaro.io/api-reference/admin/create-category.md)
- [Create Coupon](https://docs.vellaro.io/api-reference/admin/create-coupon.md): Admin: create a new coupon.
- [Create Order Refund](https://docs.vellaro.io/api-reference/admin/create-order-refund.md): Admin: issue a full or partial refund.
- [Create Order Shipment](https://docs.vellaro.io/api-reference/admin/create-order-shipment.md): Admin: add a shipment tracking entry to an order + record it on the timeline.
- [Create Product](https://docs.vellaro.io/api-reference/admin/create-product.md): Create a product with optional inline variants.
- [Create Product Discount](https://docs.vellaro.io/api-reference/admin/create-product-discount.md): Admin: create a discount for a product.
- [Create Product Reward](https://docs.vellaro.io/api-reference/admin/create-product-reward.md): Admin: create a reward for a product.
- [Create Product Special](https://docs.vellaro.io/api-reference/admin/create-product-special.md): Admin: create a special for a product.
- [Create Variant](https://docs.vellaro.io/api-reference/admin/create-variant.md)
- [Customer Orders](https://docs.vellaro.io/api-reference/admin/customer-orders.md): Admin: paginated orders for a specific customer.
- [Customer Template](https://docs.vellaro.io/api-reference/admin/customer-template.md)
- [Customers Report](https://docs.vellaro.io/api-reference/admin/customers-report.md): New customers over time + top customers by spend in the range.
- [Dashboard Stats](https://docs.vellaro.io/api-reference/admin/dashboard-stats.md): Comprehensive dashboard analytics.
- [Deactivate Coupon](https://docs.vellaro.io/api-reference/admin/deactivate-coupon.md): Admin: soft-delete (deactivate) a coupon.
- [Deactivate Customer](https://docs.vellaro.io/api-reference/admin/deactivate-customer.md): Admin: soft-delete (deactivate) a customer.
- [Delete Attribute](https://docs.vellaro.io/api-reference/admin/delete-attribute.md)
- [Delete Attribute Group](https://docs.vellaro.io/api-reference/admin/delete-attribute-group.md)
- [Delete Brand](https://docs.vellaro.io/api-reference/admin/delete-brand.md): Admin: soft-delete (deactivate) a brand.
- [Delete Category](https://docs.vellaro.io/api-reference/admin/delete-category.md): Soft-delete: stamp deleted_at (and unpublish) instead of destroying data.
- [Delete Product Discount](https://docs.vellaro.io/api-reference/admin/delete-product-discount.md): Admin: delete a product discount.
- [Delete Product Image](https://docs.vellaro.io/api-reference/admin/delete-product-image.md): Admin: delete product image.
- [Delete Product Reward](https://docs.vellaro.io/api-reference/admin/delete-product-reward.md): Admin: delete a product reward.
- [Delete Product Special](https://docs.vellaro.io/api-reference/admin/delete-product-special.md): Admin: delete a product special.
- [Delete Question](https://docs.vellaro.io/api-reference/admin/delete-question.md): Admin: permanently delete a question.
- [Delete Review](https://docs.vellaro.io/api-reference/admin/delete-review.md): Admin: permanently delete a review.
- [Delete Variant](https://docs.vellaro.io/api-reference/admin/delete-variant.md): Delete a single variant.
- [Generate Variants](https://docs.vellaro.io/api-reference/admin/generate-variants.md): Generate variants from the cartesian product of the product's option values.
- [Get Attribute](https://docs.vellaro.io/api-reference/admin/get-attribute.md)
- [Get Attribute Group](https://docs.vellaro.io/api-reference/admin/get-attribute-group.md)
- [Get Coupon](https://docs.vellaro.io/api-reference/admin/get-coupon.md): Admin: single coupon detail with usage stats.
- [Get Customer](https://docs.vellaro.io/api-reference/admin/get-customer.md): Admin: full customer detail with addresses, recent orders, wishlist.
- [Get Order Payments](https://docs.vellaro.io/api-reference/admin/get-order-payments.md): Payment summary + transaction ledger for an order.
- [Import Customers](https://docs.vellaro.io/api-reference/admin/import-customers.md)
- [Import Products](https://docs.vellaro.io/api-reference/admin/import-products.md)
- [List Attribute Groups](https://docs.vellaro.io/api-reference/admin/list-attribute-groups.md)
- [List Attributes](https://docs.vellaro.io/api-reference/admin/list-attributes.md)
- [List Coupons](https://docs.vellaro.io/api-reference/admin/list-coupons.md): Admin: paginated coupon list.
- [List Customer Activities](https://docs.vellaro.io/api-reference/admin/list-customer-activities.md): Admin: list activity log for a customer.
- [List Customer Rewards](https://docs.vellaro.io/api-reference/admin/list-customer-rewards.md): Admin: list reward points for a customer.
- [List Customer Transactions](https://docs.vellaro.io/api-reference/admin/list-customer-transactions.md): Admin: list monetary transactions for a customer.
- [List Customers](https://docs.vellaro.io/api-reference/admin/list-customers.md): Admin: paginated list of this tenant's customers with order stats.
- [List Order Shipments](https://docs.vellaro.io/api-reference/admin/list-order-shipments.md): Admin: list shipment tracking entries for an order.
- [List Order Totals](https://docs.vellaro.io/api-reference/admin/list-order-totals.md): Admin: list extra total lines for an order (shipping, tax, coupon, etc.).
- [List Product Attributes](https://docs.vellaro.io/api-reference/admin/list-product-attributes.md)
- [List Product Categories](https://docs.vellaro.io/api-reference/admin/list-product-categories.md): Admin: list all categories assigned to a product (via M2M).
- [List Product Discounts](https://docs.vellaro.io/api-reference/admin/list-product-discounts.md): Admin: list all discounts for a product.
- [List Product Filters](https://docs.vellaro.io/api-reference/admin/list-product-filters.md): Admin: list all filter IDs assigned to a product.
- [List Product Options](https://docs.vellaro.io/api-reference/admin/list-product-options.md): List the options (and enabled values) assigned to a product.
- [List Product Rewards](https://docs.vellaro.io/api-reference/admin/list-product-rewards.md): Admin: list all rewards for a product.
- [List Product Specials](https://docs.vellaro.io/api-reference/admin/list-product-specials.md): Admin: list all specials for a product.
- [List Questions](https://docs.vellaro.io/api-reference/admin/list-questions.md): Admin: paginated question list with filters.
- [List Reviews](https://docs.vellaro.io/api-reference/admin/list-reviews.md): Admin: paginated review list with filters.
- [List Roles](https://docs.vellaro.io/api-reference/admin/list-roles.md): Return the role → permission matrix.
- [Low Stock Report](https://docs.vellaro.io/api-reference/admin/low-stock-report.md): Variants at or below the stock threshold (R13).
- [Product Template](https://docs.vellaro.io/api-reference/admin/product-template.md)
- [Products Report](https://docs.vellaro.io/api-reference/admin/products-report.md): Best-selling products in the range (revenue + quantity + order count).
- [Reindex](https://docs.vellaro.io/api-reference/admin/reindex.md): Bulk-reindex all active products into Meilisearch. Run on initial setup or after bulk changes.
- [Replace Product Attributes](https://docs.vellaro.io/api-reference/admin/replace-product-attributes.md): Replace the full attribute set assigned to a product (idempotent).
- [Replace Product Options](https://docs.vellaro.io/api-reference/admin/replace-product-options.md): Replace the full set of options + enabled values for a product.
- [Resend Order Email](https://docs.vellaro.io/api-reference/admin/resend-order-email.md): Admin: re-enqueue a transactional email for this order.
- [Sales Report](https://docs.vellaro.io/api-reference/admin/sales-report.md): Revenue/orders over a date range with previous-period deltas + breakdowns.
- [Set Product Categories](https://docs.vellaro.io/api-reference/admin/set-product-categories.md): Admin: replace all category associations for a product.
- [Set Product Filters](https://docs.vellaro.io/api-reference/admin/set-product-filters.md): Admin: replace all filter associations for a product.
- [Soft Delete Product](https://docs.vellaro.io/api-reference/admin/soft-delete-product.md): Soft-delete: stamp deleted_at (and unpublish) instead of destroying data.
- [Update Attribute](https://docs.vellaro.io/api-reference/admin/update-attribute.md)
- [Update Attribute Group](https://docs.vellaro.io/api-reference/admin/update-attribute-group.md)
- [Update Brand](https://docs.vellaro.io/api-reference/admin/update-brand.md): Admin: update a brand.
- [Update Category](https://docs.vellaro.io/api-reference/admin/update-category.md)
- [Update Coupon](https://docs.vellaro.io/api-reference/admin/update-coupon.md): Admin: update coupon fields.
- [Update Customer](https://docs.vellaro.io/api-reference/admin/update-customer.md): Admin: update customer fields.
- [Update Product](https://docs.vellaro.io/api-reference/admin/update-product.md): Partial-update a product.
- [Update Product Discount](https://docs.vellaro.io/api-reference/admin/update-product-discount.md): Admin: update a product discount.
- [Update Product Image](https://docs.vellaro.io/api-reference/admin/update-product-image.md): Admin: update product image.
- [Update Product Special](https://docs.vellaro.io/api-reference/admin/update-product-special.md): Admin: update a product special.
- [Update Question](https://docs.vellaro.io/api-reference/admin/update-question.md): Admin: approve/reject, edit the body, or post an official answer.
- [Update Review](https://docs.vellaro.io/api-reference/admin/update-review.md): Admin: update review (approve/reject, edit body).
- [Update Stock](https://docs.vellaro.io/api-reference/admin/update-stock.md): Atomically adjust stock (delta can be positive or negative).
- [Update Variant](https://docs.vellaro.io/api-reference/admin/update-variant.md)
- [Approve Commission](https://docs.vellaro.io/api-reference/admin:affiliates/approve-commission.md)
- [Commissions Summary](https://docs.vellaro.io/api-reference/admin:affiliates/commissions-summary.md): Admin: per-affiliate totals by status (powers the payout report).
- [Create Affiliate](https://docs.vellaro.io/api-reference/admin:affiliates/create-affiliate.md): Admin: create a new affiliate.
- [Delete Affiliate](https://docs.vellaro.io/api-reference/admin:affiliates/delete-affiliate.md): Admin: permanently delete an affiliate.
- [Get Affiliate](https://docs.vellaro.io/api-reference/admin:affiliates/get-affiliate.md): Admin: get a single affiliate by ID.
- [List Affiliates](https://docs.vellaro.io/api-reference/admin:affiliates/list-affiliates.md): Admin: paginated list of all affiliates.
- [List Commissions](https://docs.vellaro.io/api-reference/admin:affiliates/list-commissions.md): Admin: paginated commission ledger (newest first).
- [Mark Commission Paid](https://docs.vellaro.io/api-reference/admin:affiliates/mark-commission-paid.md)
- [Reject Commission](https://docs.vellaro.io/api-reference/admin:affiliates/reject-commission.md)
- [Update Affiliate](https://docs.vellaro.io/api-reference/admin:affiliates/update-affiliate.md): Admin: update affiliate fields.
- [Generate](https://docs.vellaro.io/api-reference/admin:ai/generate.md)
- [Test Credentials](https://docs.vellaro.io/api-reference/admin:ai/test-credentials.md)
- [List Admin Audit](https://docs.vellaro.io/api-reference/admin:audit-log/list-admin-audit.md)
- [Add Banner Image](https://docs.vellaro.io/api-reference/admin:banners/add-banner-image.md): Admin: add an image / slide to a banner.
- [Create Banner](https://docs.vellaro.io/api-reference/admin:banners/create-banner.md): Admin: create a new banner.
- [Delete Banner](https://docs.vellaro.io/api-reference/admin:banners/delete-banner.md): Admin: permanently delete a banner and all its images.
- [Delete Banner Image](https://docs.vellaro.io/api-reference/admin:banners/delete-banner-image.md): Admin: delete a banner image.
- [List Banners](https://docs.vellaro.io/api-reference/admin:banners/list-banners.md): Admin: paginated list of all banners with their images.
- [Update Banner](https://docs.vellaro.io/api-reference/admin:banners/update-banner.md): Admin: update banner fields.
- [Update Banner Image](https://docs.vellaro.io/api-reference/admin:banners/update-banner-image.md): Admin: update a banner image.
- [Chat Analytics](https://docs.vellaro.io/api-reference/admin:chat/chat-analytics.md): Aggregate KPIs for the AI Chat dashboard.
- [Chat Health](https://docs.vellaro.io/api-reference/admin:chat/chat-health.md): Diagnostic endpoint. Aggregates Qdrant reachability, settings state, index status, and budget. Issues list is human-readable so the admin UI can surface action items without further parsing.
- [Generate Chat Config](https://docs.vellaro.io/api-reference/admin:chat/generate-chat-config.md): Generate assistant rules + welcome/starters per language + SEO meta from the store's SECTOR, using the tenant's configured AI provider/key. Returns a draft for the admin to review and save (nothing is persisted here).
- [Get Chat Settings](https://docs.vellaro.io/api-reference/admin:chat/get-chat-settings.md): Return the tenant's chat config, creating a default disabled row on first read so the admin UI can edit it immediately.
- [Get Conversation Detail](https://docs.vellaro.io/api-reference/admin:chat/get-conversation-detail.md): Full conversation with all messages — for the operator review pane.
- [Get Index State](https://docs.vellaro.io/api-reference/admin:chat/get-index-state.md): Tenant's indexing watermark + last error. Drives the admin UI indicator ("Catalog ready · 1234 prodotti indicizzati").
- [List Conversations](https://docs.vellaro.io/api-reference/admin:chat/list-conversations.md): List conversations with summary metadata for the review table.
- [Trigger Reindex](https://docs.vellaro.io/api-reference/admin:chat/trigger-reindex.md): Schedule a full reindex of the tenant's catalog.
- [Update Chat Settings](https://docs.vellaro.io/api-reference/admin:chat/update-chat-settings.md)
- [Create Currency](https://docs.vellaro.io/api-reference/admin:currencies/create-currency.md): Admin: create a new currency.
- [Delete Currency](https://docs.vellaro.io/api-reference/admin:currencies/delete-currency.md): Admin: permanently delete a currency.
- [List Currencies](https://docs.vellaro.io/api-reference/admin:currencies/list-currencies.md): Admin: paginated list of all currencies.
- [Update Currency](https://docs.vellaro.io/api-reference/admin:currencies/update-currency.md): Admin: update currency fields.
- [Add Custom Field Value](https://docs.vellaro.io/api-reference/admin:custom-fields/add-custom-field-value.md): Admin: add a predefined value to a custom field.
- [Create Custom Field](https://docs.vellaro.io/api-reference/admin:custom-fields/create-custom-field.md): Admin: create a new custom field.
- [Delete Custom Field](https://docs.vellaro.io/api-reference/admin:custom-fields/delete-custom-field.md): Admin: permanently delete a custom field and its values.
- [Delete Custom Field Value](https://docs.vellaro.io/api-reference/admin:custom-fields/delete-custom-field-value.md): Admin: delete a predefined value from a custom field.
- [List Custom Fields](https://docs.vellaro.io/api-reference/admin:custom-fields/list-custom-fields.md): Admin: list all custom fields, optionally filtered by location.
- [Update Custom Field](https://docs.vellaro.io/api-reference/admin:custom-fields/update-custom-field.md): Admin: update a custom field.
- [Create Customer Group](https://docs.vellaro.io/api-reference/admin:customer-groups/create-customer-group.md): Admin: create a new customer group.
- [Delete Customer Group](https://docs.vellaro.io/api-reference/admin:customer-groups/delete-customer-group.md): Admin: soft-delete a customer group (set is_active=False).
- [Get Customer Group](https://docs.vellaro.io/api-reference/admin:customer-groups/get-customer-group.md): Admin: get a single customer group by ID.
- [List Customer Groups](https://docs.vellaro.io/api-reference/admin:customer-groups/list-customer-groups.md): Admin: paginated list of customer groups ordered by sort_order.
- [Update Customer Group](https://docs.vellaro.io/api-reference/admin:customer-groups/update-customer-group.md): Admin: update customer group fields.
- [Download Invoice Pdf](https://docs.vellaro.io/api-reference/admin:documents/download-invoice-pdf.md): Stream the invoice PDF for the given order.
- [Download Shipping Pdf](https://docs.vellaro.io/api-reference/admin:documents/download-shipping-pdf.md): Stream the DDT (shipping note) PDF for the given order in the requested language.
- [Create Download](https://docs.vellaro.io/api-reference/admin:downloads/create-download.md): Admin: create a new download.
- [Delete Download](https://docs.vellaro.io/api-reference/admin:downloads/delete-download.md): Admin: permanently delete a download.
- [List Downloads](https://docs.vellaro.io/api-reference/admin:downloads/list-downloads.md): Admin: list all downloads.
- [Update Download](https://docs.vellaro.io/api-reference/admin:downloads/update-download.md): Admin: update a download.
- [Get Template](https://docs.vellaro.io/api-reference/admin:email-templates/get-template.md): Per-locale default + override for one key, plus the variable palette.
- [List Templates](https://docs.vellaro.io/api-reference/admin:email-templates/list-templates.md): Catalogue of editable templates with per-key override status.
- [Preview Template](https://docs.vellaro.io/api-reference/admin:email-templates/preview-template.md): Render a draft (subject/body from the editor, possibly unsaved) with sample data for `key`, in the tenant's own brand context. Full render, so it catches undefined variables and bad filters — mapped to a 422.
- [Reset Override](https://docs.vellaro.io/api-reference/admin:email-templates/reset-override.md): Drop the tenant override for `(key, locale)` → the system falls back to the shipped default. Idempotent: resetting a non-overridden locale is a no-op that still returns the default state.
- [Upsert Override](https://docs.vellaro.io/api-reference/admin:email-templates/upsert-override.md): Create or replace the tenant's override for `(key, locale)`.
- [Create Filter](https://docs.vellaro.io/api-reference/admin:filters/create-filter.md): Admin: create a filter within a group.
- [Create Filter Group](https://docs.vellaro.io/api-reference/admin:filters/create-filter-group.md): Admin: create a new filter group.
- [Delete Filter](https://docs.vellaro.io/api-reference/admin:filters/delete-filter.md): Admin: delete a single filter.
- [Delete Filter Group](https://docs.vellaro.io/api-reference/admin:filters/delete-filter-group.md): Admin: delete a filter group and all its filters (cascade).
- [List Filter Groups](https://docs.vellaro.io/api-reference/admin:filters/list-filter-groups.md): Admin: paginated list of filter groups with their filters.
- [Update Filter](https://docs.vellaro.io/api-reference/admin:filters/update-filter.md): Admin: update filter fields.
- [Update Filter Group](https://docs.vellaro.io/api-reference/admin:filters/update-filter-group.md): Admin: update filter group fields.
- [Delete Firebase Config](https://docs.vellaro.io/api-reference/admin:firebase/delete-firebase-config.md)
- [Get Firebase Config](https://docs.vellaro.io/api-reference/admin:firebase/get-firebase-config.md): Return the tenant's Firebase config, or None when unset.
- [Test Send](https://docs.vellaro.io/api-reference/admin:firebase/test-send.md): Send a test FCM push to verify the config is correct.
- [Upsert Firebase Config](https://docs.vellaro.io/api-reference/admin:firebase/upsert-firebase-config.md)
- [Create Country](https://docs.vellaro.io/api-reference/admin:geo/create-country.md): Admin: create a new country.
- [Create Geo Zone](https://docs.vellaro.io/api-reference/admin:geo/create-geo-zone.md): Admin: create a new geo-zone.
- [Create Zone](https://docs.vellaro.io/api-reference/admin:geo/create-zone.md): Admin: create a new zone.
- [Create Zone Mapping](https://docs.vellaro.io/api-reference/admin:geo/create-zone-mapping.md): Admin: create a zone-to-geo-zone mapping.
- [Delete Country](https://docs.vellaro.io/api-reference/admin:geo/delete-country.md): Admin: permanently delete a country (cascades zones and mappings).
- [Delete Geo Zone](https://docs.vellaro.io/api-reference/admin:geo/delete-geo-zone.md): Admin: permanently delete a geo-zone (cascades mappings and tax rates).
- [Delete Zone](https://docs.vellaro.io/api-reference/admin:geo/delete-zone.md): Admin: permanently delete a zone.
- [Delete Zone Mapping](https://docs.vellaro.io/api-reference/admin:geo/delete-zone-mapping.md): Admin: permanently delete a zone-to-geo-zone mapping.
- [List Countries](https://docs.vellaro.io/api-reference/admin:geo/list-countries.md): Admin: paginated list of countries.
- [List Geo Zones](https://docs.vellaro.io/api-reference/admin:geo/list-geo-zones.md): Admin: paginated list of geo-zones.
- [List Zone Mappings](https://docs.vellaro.io/api-reference/admin:geo/list-zone-mappings.md): Admin: paginated list of zone-to-geo-zone mappings, optionally filtered.
- [List Zones](https://docs.vellaro.io/api-reference/admin:geo/list-zones.md): Admin: paginated list of zones, optionally filtered by country.
- [Update Country](https://docs.vellaro.io/api-reference/admin:geo/update-country.md): Admin: update country fields.
- [Update Geo Zone](https://docs.vellaro.io/api-reference/admin:geo/update-geo-zone.md): Admin: update geo-zone fields.
- [Update Zone](https://docs.vellaro.io/api-reference/admin:geo/update-zone.md): Admin: update zone fields.
- [Update Zone Mapping](https://docs.vellaro.io/api-reference/admin:geo/update-zone-mapping.md): Admin: update a zone-to-geo-zone mapping.
- [Create Information](https://docs.vellaro.io/api-reference/admin:information/create-information.md): Admin: create a new information page.
- [Delete Information](https://docs.vellaro.io/api-reference/admin:information/delete-information.md): Admin: permanently delete an information page.
- [List Information](https://docs.vellaro.io/api-reference/admin:information/list-information.md): Admin: paginated list of all information pages.
- [Update Information](https://docs.vellaro.io/api-reference/admin:information/update-information.md): Admin: update information page fields.
- [Delete Integration](https://docs.vellaro.io/api-reference/admin:integrations/delete-integration.md): Hard-delete the (tenant, provider) row.
- [Get Integration](https://docs.vellaro.io/api-reference/admin:integrations/get-integration.md)
- [List Integrations](https://docs.vellaro.io/api-reference/admin:integrations/list-integrations.md): All integrations configured for the current tenant (redacted).
- [List Supported Providers](https://docs.vellaro.io/api-reference/admin:integrations/list-supported-providers.md): List provider keys + their JSON schema.
- [Toggle Integration](https://docs.vellaro.io/api-reference/admin:integrations/toggle-integration.md): Flip `is_active`. Idempotent on the inverse — calling twice returns to the original state, which the operator can observe via the returned row.
- [Upsert Integration](https://docs.vellaro.io/api-reference/admin:integrations/upsert-integration.md): Create or update the (tenant, provider) row.
- [Admin List Languages](https://docs.vellaro.io/api-reference/admin:languages/admin-list-languages.md): Admin: paginated list of all languages (including inactive).
- [Create Language](https://docs.vellaro.io/api-reference/admin:languages/create-language.md): Admin: create a new language.
- [Delete Language](https://docs.vellaro.io/api-reference/admin:languages/delete-language.md): Admin: soft-delete (deactivate) a language. Cannot delete the default language.
- [Update Language](https://docs.vellaro.io/api-reference/admin:languages/update-language.md): Admin: update language fields.
- [Add Subscriber](https://docs.vellaro.io/api-reference/admin:marketing/add-subscriber.md): Admin: add a newsletter subscriber.
- [Create Campaign](https://docs.vellaro.io/api-reference/admin:marketing/create-campaign.md): Admin: create a new marketing campaign.
- [Delete Campaign](https://docs.vellaro.io/api-reference/admin:marketing/delete-campaign.md): Admin: permanently delete a marketing campaign.
- [Delete Subscriber](https://docs.vellaro.io/api-reference/admin:marketing/delete-subscriber.md): Admin: permanently delete a newsletter subscriber.
- [List Campaigns](https://docs.vellaro.io/api-reference/admin:marketing/list-campaigns.md): Admin: paginated list of all marketing campaigns.
- [List Subscribers](https://docs.vellaro.io/api-reference/admin:marketing/list-subscribers.md): Admin: paginated list of newsletter subscribers.
- [Update Campaign](https://docs.vellaro.io/api-reference/admin:marketing/update-campaign.md): Admin: update marketing campaign fields.
- [Update Subscriber](https://docs.vellaro.io/api-reference/admin:marketing/update-subscriber.md): Admin: update a newsletter subscriber.
- [Create Folder](https://docs.vellaro.io/api-reference/admin:media/create-folder.md): Create a sub-folder under ``path`` and return the updated listing.
- [Delete Folder](https://docs.vellaro.io/api-reference/admin:media/delete-folder.md): Delete an EMPTY sub-folder.
- [Delete Media](https://docs.vellaro.io/api-reference/admin:media/delete-media.md): Delete a file.
- [List Media](https://docs.vellaro.io/api-reference/admin:media/list-media.md): List sub-folders + files under ``path``.
- [Upload Media](https://docs.vellaro.io/api-reference/admin:media/upload-media.md): Upload a file. Returns the file metadata including the stable URL.
- [Browse Remote Catalog](https://docs.vellaro.io/api-reference/admin:nextera/browse-remote-catalog.md): Browse the REMOTE catalog, annotated with what we've already linked.
- [Cancel Order Invoice](https://docs.vellaro.io/api-reference/admin:nextera/cancel-order-invoice.md): Storno: cancel a fiscalized (Success) invoice.
- [Fiscalize Order](https://docs.vellaro.io/api-reference/admin:nextera/fiscalize-order.md): Fiscalize the order at Nextera, or re-present the invoice it already has.
- [Get Import Draft](https://docs.vellaro.io/api-reference/admin:nextera/get-import-draft.md): Precompile the admin product form from one remote product.
- [Get Order Invoice](https://docs.vellaro.io/api-reference/admin:nextera/get-order-invoice.md): The order's fiscal invoice, or null if it was never fiscalized. A Pending one is refreshed from Nextera so the UI's poll advances it.
- [Get Overview](https://docs.vellaro.io/api-reference/admin:nextera/get-overview.md): The dashboard's status cards in one call. NOT behind `_require_enabled`: the dashboard is where the operator sees WHY the module is off (no key, ping failed), so it must answer even when disabled.
- [Get Settings](https://docs.vellaro.io/api-reference/admin:nextera/get-settings.md)
- [Get Sync Status](https://docs.vellaro.io/api-reference/admin:nextera/get-sync-status.md): State of both delta streams + any run in flight. `_require_enabled` makes this 409 when the module is off — the page shows that explicitly.
- [Import One Product](https://docs.vellaro.io/api-reference/admin:nextera/import-one-product.md): Import ONE product with the data the operator completed in the form.
- [Import Selected Products](https://docs.vellaro.io/api-reference/admin:nextera/import-selected-products.md): Import the operator's chosen products. Per-row savepoint, so one bad product reports an error without rolling back the rest of the batch.
- [List Fiscal Invoices](https://docs.vellaro.io/api-reference/admin:nextera/list-fiscal-invoices.md): The fiscal-invoices overview. Fiscalizing happens from the order detail; this is the read-only ledger, so the operator can find a failed invoice and jump to its order to retry.
- [List Remote Categories](https://docs.vellaro.io/api-reference/admin:nextera/list-remote-categories.md): Nextera's categories, for the catalog browser filter.
- [List Sync Runs](https://docs.vellaro.io/api-reference/admin:nextera/list-sync-runs.md): Paginated run history. `page_size` capped — the rows JSONB per run can be large, so we never hand back an unbounded page.
- [List Warehouses](https://docs.vellaro.io/api-reference/admin:nextera/list-warehouses.md): Live warehouse list for the settings multi-select. Deliberately NOT behind `_require_enabled`: you must pick warehouses before enabling.
- [Retry Order Invoice](https://docs.vellaro.io/api-reference/admin:nextera/retry-order-invoice.md): Re-push a Pending/Failed invoice to CIS.
- [Test Connection](https://docs.vellaro.io/api-reference/admin:nextera/test-connection.md): Live ping + warehouse fetch. Works even while the module is disabled — that is the point: you test BEFORE flipping the switch.
- [Trigger Sync](https://docs.vellaro.io/api-reference/admin:nextera/trigger-sync.md): Queue a manual delta. ASYNC on purpose — running the sync inline once gave a gateway-timeout 500 with the run stuck `running`; the worker owns it and the page polls GET /sync. 409 when a run is already in flight.
- [Update Settings](https://docs.vellaro.io/api-reference/admin:nextera/update-settings.md)
- [Add Option Value](https://docs.vellaro.io/api-reference/admin:options/add-option-value.md): Admin: add a value to an existing option.
- [Create Option](https://docs.vellaro.io/api-reference/admin:options/create-option.md): Admin: create a new option.
- [Delete Option](https://docs.vellaro.io/api-reference/admin:options/delete-option.md): Admin: hard-delete an option and its values (cascade).
- [Delete Option Value](https://docs.vellaro.io/api-reference/admin:options/delete-option-value.md): Admin: hard-delete an option value.
- [Get Option](https://docs.vellaro.io/api-reference/admin:options/get-option.md): Admin: single option detail with values.
- [List Options](https://docs.vellaro.io/api-reference/admin:options/list-options.md): Admin: paginated option list with values.
- [Update Option](https://docs.vellaro.io/api-reference/admin:options/update-option.md): Admin: update option fields.
- [Update Option Value](https://docs.vellaro.io/api-reference/admin:options/update-option-value.md): Admin: update an option value.
- [Configure Plugin](https://docs.vellaro.io/api-reference/admin:plugins/configure-plugin.md)
- [Disable Plugin](https://docs.vellaro.io/api-reference/admin:plugins/disable-plugin.md)
- [Enable Plugin](https://docs.vellaro.io/api-reference/admin:plugins/enable-plugin.md)
- [Get Plugin](https://docs.vellaro.io/api-reference/admin:plugins/get-plugin.md)
- [Install Plugin](https://docs.vellaro.io/api-reference/admin:plugins/install-plugin.md)
- [List Catalog](https://docs.vellaro.io/api-reference/admin:plugins/list-catalog.md): Full catalog with this tenant's install state merged in.
- [Uninstall Plugin](https://docs.vellaro.io/api-reference/admin:plugins/uninstall-plugin.md)
- [Create Recurring](https://docs.vellaro.io/api-reference/admin:recurrings/create-recurring.md): Admin: create a new recurring billing profile.
- [Delete Recurring](https://docs.vellaro.io/api-reference/admin:recurrings/delete-recurring.md): Admin: permanently delete a recurring billing profile.
- [List Recurring Options](https://docs.vellaro.io/api-reference/admin:recurrings/list-recurring-options.md): Plan options for the product attach selector. Sales-scoped (the product form is reachable by catalog/sales operators, not only system admins) and returns only active plans with the minimal fields the selector renders.
- [List Recurrings](https://docs.vellaro.io/api-reference/admin:recurrings/list-recurrings.md): Admin: list all recurring billing profiles.
- [Update Recurring](https://docs.vellaro.io/api-reference/admin:recurrings/update-recurring.md): Admin: update a recurring billing profile.
- [Add Return History](https://docs.vellaro.io/api-reference/admin:returns/add-return-history.md): Admin: add a history entry to a return (status change / comment).
- [Create Return](https://docs.vellaro.io/api-reference/admin:returns/create-return.md): Admin: create a new return / RMA request.
- [Create Return Action](https://docs.vellaro.io/api-reference/admin:returns/create-return-action.md): Admin: create a new return action.
- [Create Return Reason](https://docs.vellaro.io/api-reference/admin:returns/create-return-reason.md): Admin: create a new return reason.
- [Create Return Status](https://docs.vellaro.io/api-reference/admin:returns/create-return-status.md): Admin: create a new return status.
- [Delete Return](https://docs.vellaro.io/api-reference/admin:returns/delete-return.md): Admin: permanently delete a return and its history.
- [Delete Return Action](https://docs.vellaro.io/api-reference/admin:returns/delete-return-action.md): Admin: permanently delete a return action.
- [Delete Return Reason](https://docs.vellaro.io/api-reference/admin:returns/delete-return-reason.md): Admin: permanently delete a return reason.
- [Delete Return Status](https://docs.vellaro.io/api-reference/admin:returns/delete-return-status.md): Admin: permanently delete a return status.
- [Get Return](https://docs.vellaro.io/api-reference/admin:returns/get-return.md): Admin: single return detail with nested lookups.
- [List Return Actions](https://docs.vellaro.io/api-reference/admin:returns/list-return-actions.md): Admin: list all return actions ordered by sort_order.
- [List Return History](https://docs.vellaro.io/api-reference/admin:returns/list-return-history.md): Admin: list history entries for a return.
- [List Return Reasons](https://docs.vellaro.io/api-reference/admin:returns/list-return-reasons.md): Admin: list all return reasons ordered by sort_order.
- [List Return Statuses](https://docs.vellaro.io/api-reference/admin:returns/list-return-statuses.md): Admin: list all return statuses ordered by sort_order.
- [List Returns](https://docs.vellaro.io/api-reference/admin:returns/list-returns.md): Admin: paginated return list with nested lookups.
- [Update Return](https://docs.vellaro.io/api-reference/admin:returns/update-return.md): Admin: update return fields.
- [Update Return Action](https://docs.vellaro.io/api-reference/admin:returns/update-return-action.md): Admin: update a return action.
- [Update Return Reason](https://docs.vellaro.io/api-reference/admin:returns/update-return-reason.md): Admin: update a return reason.
- [Update Return Status](https://docs.vellaro.io/api-reference/admin:returns/update-return-status.md): Admin: update a return status.
- [Create Seo Url](https://docs.vellaro.io/api-reference/admin:seo/create-seo-url.md): Admin: create a new SEO URL mapping.
- [Delete Seo Url](https://docs.vellaro.io/api-reference/admin:seo/delete-seo-url.md): Admin: permanently delete a SEO URL.
- [List Seo Urls](https://docs.vellaro.io/api-reference/admin:seo/list-seo-urls.md): Admin: paginated list of all SEO URLs, optionally filtered by entity_type.
- [Update Seo Url](https://docs.vellaro.io/api-reference/admin:seo/update-seo-url.md): Admin: update SEO URL fields.
- [Batch Upsert Settings](https://docs.vellaro.io/api-reference/admin:settings/batch-upsert-settings.md): Batch upsert: insert or update settings within a group (this tenant).
- [Get Settings By Group](https://docs.vellaro.io/api-reference/admin:settings/get-settings-by-group.md): Return all settings for a group as a key→value dict.
- [List Settings](https://docs.vellaro.io/api-reference/admin:settings/list-settings.md): List this tenant's settings, optionally filtered by group.
- [Create Courier](https://docs.vellaro.io/api-reference/admin:shipping/create-courier.md): Admin: create a new shipping courier.
- [Create Length Class](https://docs.vellaro.io/api-reference/admin:shipping/create-length-class.md): Admin: create a new length class.
- [Create Shipping Rate](https://docs.vellaro.io/api-reference/admin:shipping/create-shipping-rate.md): Admin: create a zone rate.
- [Create Weight Class](https://docs.vellaro.io/api-reference/admin:shipping/create-weight-class.md): Admin: create a new weight class.
- [Delete Courier](https://docs.vellaro.io/api-reference/admin:shipping/delete-courier.md): Admin: permanently delete a shipping courier.
- [Delete Length Class](https://docs.vellaro.io/api-reference/admin:shipping/delete-length-class.md): Admin: permanently delete a length class.
- [Delete Shipping Rate](https://docs.vellaro.io/api-reference/admin:shipping/delete-shipping-rate.md): Admin: permanently delete a zone rate.
- [Delete Weight Class](https://docs.vellaro.io/api-reference/admin:shipping/delete-weight-class.md): Admin: permanently delete a weight class.
- [List Couriers](https://docs.vellaro.io/api-reference/admin:shipping/list-couriers.md): Admin: paginated list of shipping couriers.
- [List Length Classes](https://docs.vellaro.io/api-reference/admin:shipping/list-length-classes.md): Admin: paginated list of length classes.
- [List Shipping Rates](https://docs.vellaro.io/api-reference/admin:shipping/list-shipping-rates.md): Admin: all zone rates, grouped by zone then band order.
- [List Weight Classes](https://docs.vellaro.io/api-reference/admin:shipping/list-weight-classes.md): Admin: paginated list of weight classes.
- [Update Courier](https://docs.vellaro.io/api-reference/admin:shipping/update-courier.md): Admin: update courier fields.
- [Update Length Class](https://docs.vellaro.io/api-reference/admin:shipping/update-length-class.md): Admin: update length class fields.
- [Update Shipping Rate](https://docs.vellaro.io/api-reference/admin:shipping/update-shipping-rate.md): Admin: update a zone rate.
- [Update Weight Class](https://docs.vellaro.io/api-reference/admin:shipping/update-weight-class.md): Admin: update weight class fields.
- [Create Stock Status](https://docs.vellaro.io/api-reference/admin:stock-statuses/create-stock-status.md): Admin: create a new stock status.
- [Delete Stock Status](https://docs.vellaro.io/api-reference/admin:stock-statuses/delete-stock-status.md): Admin: permanently delete a stock status.
- [List Stock Statuses](https://docs.vellaro.io/api-reference/admin:stock-statuses/list-stock-statuses.md): Admin: list all stock statuses ordered by sort_order.
- [Update Stock Status](https://docs.vellaro.io/api-reference/admin:stock-statuses/update-stock-status.md): Admin: update stock status fields.
- [Create Store](https://docs.vellaro.io/api-reference/admin:stores/create-store.md)
- [Delete Store](https://docs.vellaro.io/api-reference/admin:stores/delete-store.md)
- [Get Store](https://docs.vellaro.io/api-reference/admin:stores/get-store.md)
- [List Stores](https://docs.vellaro.io/api-reference/admin:stores/list-stores.md)
- [Update Store](https://docs.vellaro.io/api-reference/admin:stores/update-store.md)
- [Admin Cancel](https://docs.vellaro.io/api-reference/admin:subscriptions/admin-cancel.md)
- [Admin List Subscriptions](https://docs.vellaro.io/api-reference/admin:subscriptions/admin-list-subscriptions.md)
- [Admin Pause](https://docs.vellaro.io/api-reference/admin:subscriptions/admin-pause.md)
- [Admin Resume](https://docs.vellaro.io/api-reference/admin:subscriptions/admin-resume.md)
- [Get Product Recurrings](https://docs.vellaro.io/api-reference/admin:subscriptions/get-product-recurrings.md)
- [Set Product Recurrings](https://docs.vellaro.io/api-reference/admin:subscriptions/set-product-recurrings.md): Replace the product's recurring plans. RLS confines lookups to the tenant's own Recurring rows, so cross-tenant plans can't be attached.
- [Create Tax Class](https://docs.vellaro.io/api-reference/admin:tax/create-tax-class.md): Admin: create a new tax class.
- [Create Tax Rate](https://docs.vellaro.io/api-reference/admin:tax/create-tax-rate.md): Admin: create a new tax rate.
- [Create Tax Rule](https://docs.vellaro.io/api-reference/admin:tax/create-tax-rule.md): Admin: create a new tax rule.
- [Delete Tax Class](https://docs.vellaro.io/api-reference/admin:tax/delete-tax-class.md): Admin: permanently delete a tax class (cascades rules).
- [Delete Tax Rate](https://docs.vellaro.io/api-reference/admin:tax/delete-tax-rate.md): Admin: permanently delete a tax rate (cascades rules).
- [Delete Tax Rule](https://docs.vellaro.io/api-reference/admin:tax/delete-tax-rule.md): Admin: permanently delete a tax rule.
- [List Tax Classes](https://docs.vellaro.io/api-reference/admin:tax/list-tax-classes.md): Admin: paginated list of tax classes.
- [List Tax Rates](https://docs.vellaro.io/api-reference/admin:tax/list-tax-rates.md): Admin: paginated list of tax rates.
- [List Tax Rules](https://docs.vellaro.io/api-reference/admin:tax/list-tax-rules.md): Admin: paginated list of tax rules.
- [Update Tax Class](https://docs.vellaro.io/api-reference/admin:tax/update-tax-class.md): Admin: update tax class fields.
- [Update Tax Rate](https://docs.vellaro.io/api-reference/admin:tax/update-tax-rate.md): Admin: update tax rate fields.
- [Update Tax Rule](https://docs.vellaro.io/api-reference/admin:tax/update-tax-rule.md): Admin: update tax rule fields.
- [Batch Upsert Translations](https://docs.vellaro.io/api-reference/admin:translations/batch-upsert-translations.md): Batch upsert translations for a namespace + language.
- [List Translations](https://docs.vellaro.io/api-reference/admin:translations/list-translations.md): List all translations with optional filters.
- [Add Voucher History](https://docs.vellaro.io/api-reference/admin:vouchers/add-voucher-history.md): Admin: record a voucher redemption.
- [Create Voucher](https://docs.vellaro.io/api-reference/admin:vouchers/create-voucher.md): Admin: create a new gift voucher.
- [Create Voucher Theme](https://docs.vellaro.io/api-reference/admin:vouchers/create-voucher-theme.md): Admin: create a new voucher theme.
- [Deactivate Voucher](https://docs.vellaro.io/api-reference/admin:vouchers/deactivate-voucher.md): Admin: soft-delete (deactivate) a voucher.
- [Delete Voucher Theme](https://docs.vellaro.io/api-reference/admin:vouchers/delete-voucher-theme.md): Admin: permanently delete a voucher theme.
- [Get Voucher](https://docs.vellaro.io/api-reference/admin:vouchers/get-voucher.md): Admin: single voucher detail with remaining balance.
- [List Voucher History](https://docs.vellaro.io/api-reference/admin:vouchers/list-voucher-history.md): Admin: list redemption history for a voucher.
- [List Voucher Themes](https://docs.vellaro.io/api-reference/admin:vouchers/list-voucher-themes.md): Admin: list all voucher themes.
- [List Vouchers](https://docs.vellaro.io/api-reference/admin:vouchers/list-vouchers.md): Admin: paginated voucher list with remaining balance.
- [Update Voucher](https://docs.vellaro.io/api-reference/admin:vouchers/update-voucher.md): Admin: update voucher fields.
- [Update Voucher Theme](https://docs.vellaro.io/api-reference/admin:vouchers/update-voucher-theme.md): Admin: update a voucher theme.
- [Create Subscription](https://docs.vellaro.io/api-reference/admin:webhooks/create-subscription.md): Create a subscription. The signing secret is returned ONCE here.
- [Delete Subscription](https://docs.vellaro.io/api-reference/admin:webhooks/delete-subscription.md)
- [Get Subscription](https://docs.vellaro.io/api-reference/admin:webhooks/get-subscription.md)
- [List Deliveries](https://docs.vellaro.io/api-reference/admin:webhooks/list-deliveries.md): Admin: recent delivery attempts for a subscription.
- [List Event Types](https://docs.vellaro.io/api-reference/admin:webhooks/list-event-types.md): The fixed set of event types a subscription may listen to.
- [List Subscriptions](https://docs.vellaro.io/api-reference/admin:webhooks/list-subscriptions.md): Admin: all webhook subscriptions for the tenant.
- [Update Subscription](https://docs.vellaro.io/api-reference/admin:webhooks/update-subscription.md)
- [Disable 2Fa](https://docs.vellaro.io/api-reference/auth/disable-2fa.md): Turn 2FA off. Requires a CURRENT valid TOTP code (proof of device possession) — a stolen session alone can't silently weaken the account. Lost device → an operator resets it via the admin users management.
- [Forgot Password](https://docs.vellaro.io/api-reference/auth/forgot-password.md): Initiate password reset. Always returns 200 to avoid email enumeration attacks.
- [Get Me](https://docs.vellaro.io/api-reference/auth/get-me.md)
- [Google Callback](https://docs.vellaro.io/api-reference/auth/google-callback.md): Handle Google's redirect: verify, link-or-create, mint tokens, bounce back to the storefront with tokens in the URL fragment.
- [Google Login](https://docs.vellaro.io/api-reference/auth/google-login.md): Kick off the Google consent flow (full-page browser redirect).
- [Login](https://docs.vellaro.io/api-reference/auth/login.md)
- [Refresh Token](https://docs.vellaro.io/api-reference/auth/refresh-token.md)
- [Register](https://docs.vellaro.io/api-reference/auth/register.md)
- [Reset Password](https://docs.vellaro.io/api-reference/auth/reset-password.md): Verify reset token and set new password.
- [Setup 2Fa](https://docs.vellaro.io/api-reference/auth/setup-2fa.md)
- [Verify 2Fa](https://docs.vellaro.io/api-reference/auth/verify-2fa.md)
- [Verify Email Confirm](https://docs.vellaro.io/api-reference/auth/verify-email-confirm.md): Confirm the address from the emailed token (R8). Idempotent.
- [Verify Email Resend](https://docs.vellaro.io/api-reference/auth/verify-email-resend.md): Re-send the verification email for the logged-in account (R8).
- [Get Public Banner By Name](https://docs.vellaro.io/api-reference/banners/get-public-banner-by-name.md): Public: first active banner matching the given name, with images.
- [List Public Banners](https://docs.vellaro.io/api-reference/banners/list-public-banners.md): Public: list all active banners with their images, sorted by name.
- [List Brands](https://docs.vellaro.io/api-reference/brands/list-brands.md)
- [Add Item](https://docs.vellaro.io/api-reference/cart/add-item.md): Add a variant to the cart. If already present, increments quantity.
- [Clear Cart](https://docs.vellaro.io/api-reference/cart/clear-cart.md): Remove all items from the cart.
- [Get Cart](https://docs.vellaro.io/api-reference/cart/get-cart.md): Get the current cart (creates one if it doesn't exist).
- [Remove Item](https://docs.vellaro.io/api-reference/cart/remove-item.md): Remove a specific item from the cart.
- [Update Item](https://docs.vellaro.io/api-reference/cart/update-item.md): Set exact quantity for a cart item.
- [Get Category](https://docs.vellaro.io/api-reference/categories/get-category.md)
- [List Categories](https://docs.vellaro.io/api-reference/categories/list-categories.md): Return all active categories — flat or nested tree.
- [Create Conversation](https://docs.vellaro.io/api-reference/chat/create-conversation.md): Open a new conversation. The client should call this once per session and reuse the returned id for subsequent /message calls.
- [End Conversation](https://docs.vellaro.io/api-reference/chat/end-conversation.md): Soft-end a conversation. Marks `ended_at` without deleting history.
- [Get Conversation](https://docs.vellaro.io/api-reference/chat/get-conversation.md)
- [Post Feedback](https://docs.vellaro.io/api-reference/chat/post-feedback.md): Thumbs up / down on a specific assistant message.
- [Post Message](https://docs.vellaro.io/api-reference/chat/post-message.md): Send a message and stream the assistant response via SSE.
- [Submit Contact](https://docs.vellaro.io/api-reference/contact/submit-contact.md): Public: deliver a contact-form message to the store inbox (rate-limited).
- [List Public Currencies](https://docs.vellaro.io/api-reference/currencies/list-public-currencies.md): Active currencies for the storefront switcher (base first).
- [List My Devices](https://docs.vellaro.io/api-reference/devices/list-my-devices.md): List devices belonging to the authenticated user.
- [Register Device](https://docs.vellaro.io/api-reference/devices/register-device.md): Register or refresh an FCM token.
- [Unregister Device](https://docs.vellaro.io/api-reference/devices/unregister-device.md): Hard-delete the device row. Called on logout.
- [Update Consent](https://docs.vellaro.io/api-reference/devices/update-consent.md): Flip the push_consent flag.
- [Download File](https://docs.vellaro.io/api-reference/downloads/download-file.md): Stream the file for a grant, gated by a single-grant signed token. Enforces ownership (via the token), expiry, revocation and the download cap; serves bytes from MEDIA_ROOT with a path-traversal guard.
- [Public Get Information](https://docs.vellaro.io/api-reference/information/public-get-information.md): Public: a single active information page by slug.
- [Public List Information](https://docs.vellaro.io/api-reference/information/public-list-information.md): Public: active information pages, ordered by sort_order.
- [List Active Languages](https://docs.vellaro.io/api-reference/languages/list-active-languages.md): Public: list all active languages sorted by sort_order.
- [Server MCP](https://docs.vellaro.io/api-reference/mcp.md): I due server Model Context Protocol di Vellaro, sopra la stessa REST API.
- [Subscribe](https://docs.vellaro.io/api-reference/newsletter/subscribe.md): Public: subscribe an email to the newsletter.
- [Checkout](https://docs.vellaro.io/api-reference/orders/checkout.md): Create a Stripe PaymentIntent and a pending Order from the current cart.
- [Get Order](https://docs.vellaro.io/api-reference/orders/get-order.md): Get full order detail. Accessible by the owning user or any admin.
- [List My Orders](https://docs.vellaro.io/api-reference/orders/list-my-orders.md): List the authenticated user's orders (newest first).
- [Paypal Capture](https://docs.vellaro.io/api-reference/orders/paypal-capture.md): Capture a PayPal payment after the customer has approved it in the PayPal JS SDK popup.
- [Pokpay Confirm](https://docs.vellaro.io/api-reference/orders/pokpay-confirm.md): Storefront-driven confirmation: after the PokPay JS widget fires onSuccess the frontend calls this endpoint, we re-fetch the order from PokPay and mark the local Order paid if `isCompleted: true`. Idempotent.
- [Reorder](https://docs.vellaro.io/api-reference/orders/reorder.md): Re-order: add all available items from a previous order into the user's cart.
- [Get Product](https://docs.vellaro.io/api-reference/products/get-product.md): Public single product detail by slug.
- [List Products](https://docs.vellaro.io/api-reference/products/list-products.md): Public paginated product listing with filters.
- [Create Product Question](https://docs.vellaro.io/api-reference/questions/create-product-question.md): Submit a question for a product (auth required).
- [List Product Questions](https://docs.vellaro.io/api-reference/questions/list-product-questions.md): List approved Q&A for a product (public, paginated).
- [Create Product Review](https://docs.vellaro.io/api-reference/reviews/create-product-review.md): Submit a review for a product (auth required).
- [List Product Reviews](https://docs.vellaro.io/api-reference/reviews/list-product-reviews.md): List approved reviews for a product (public, paginated).
- [Product Review Summary](https://docs.vellaro.io/api-reference/reviews/product-review-summary.md): Review summary stats for a product (public).
- [Search](https://docs.vellaro.io/api-reference/search/search.md): Full-text product search powered by Meilisearch.
- [Suggestions](https://docs.vellaro.io/api-reference/search/suggestions.md): Autocomplete suggestions — matching products (name + slug + thumb + price) so the dropdown can link straight to the product. Tenant-scoped (R19); falls back to a Postgres ILIKE match when Meilisearch is down (R24).
- [Get Payment Methods](https://docs.vellaro.io/api-reference/settings/get-payment-methods.md): Return list of enabled payment methods (public, no auth).
- [Get Shipping Info](https://docs.vellaro.io/api-reference/settings/get-shipping-info.md): Return shipping cost info for the frontend (public).
- [Get Store Info](https://docs.vellaro.io/api-reference/settings/get-store-info.md): Public store information for the storefront (name, contacts, social).
- [List Pickup Points](https://docs.vellaro.io/api-reference/stores/list-pickup-points.md): Stores customers can pick up orders from: pickup_point and mixed.
- [List Public Stores](https://docs.vellaro.io/api-reference/stores/list-public-stores.md): All customer-facing physical locations for the storefront's "Find a store" page — sales_point, pickup_point, and mixed (which is both).
- [Health Check](https://docs.vellaro.io/api-reference/system/health-check.md)
- [Get Active Integrations](https://docs.vellaro.io/api-reference/tenant/get-active-integrations.md): Public: browser-safe view of the tenant's enabled integrations.
- [Get Active Plugins](https://docs.vellaro.io/api-reference/tenant/get-active-plugins.md): Public: browser-safe config of the tenant's ENABLED plugins that contribute to the storefront.
- [Get Firebase Public Config](https://docs.vellaro.io/api-reference/tenant/get-firebase-public-config.md): Browser-safe Firebase Web SDK config for the storefront PWA.
- [Get Tenant Brand](https://docs.vellaro.io/api-reference/tenant/get-tenant-brand.md): Public: return the current tenant's brand_config + identity bits.
- [Get Translations](https://docs.vellaro.io/api-reference/translations/get-translations.md): Return a flat dict of key->value for the given language + namespace.
- [Change Password](https://docs.vellaro.io/api-reference/users/change-password.md): Change the current user's password (requires old_password verification).
- [Update Profile](https://docs.vellaro.io/api-reference/users/update-profile.md): Update the current user's profile (full_name, avatar_url).
- [Add To Wishlist](https://docs.vellaro.io/api-reference/wishlist/add-to-wishlist.md): Add a product to the current user's wishlist.
- [List Wishlist](https://docs.vellaro.io/api-reference/wishlist/list-wishlist.md): Return all wishlist items for the current user with product data.
- [Remove From Wishlist](https://docs.vellaro.io/api-reference/wishlist/remove-from-wishlist.md): Remove a product from the current user's wishlist.
- [Autenticazione](https://docs.vellaro.io/authentication.md): Chiave publishable, sessione cliente e token staff — quando usare cosa.
- [Concetti fondamentali](https://docs.vellaro.io/concepts.md): Negozio, envelope, errori, paginazione, i18n e immagini.
- [Gestisci il negozio via API](https://docs.vellaro.io/guides/admin-api.md): Catalogo, ordini, clienti e configurazione con la Admin API.
- [Costruisci un'app mobile](https://docs.vellaro.io/guides/build-mobile.md): iOS, Android o Flutter sulla stessa Storefront API.
- [Costruisci uno storefront](https://docs.vellaro.io/guides/build-storefront.md): Catalogo → carrello → checkout → ordine, con la Storefront API.
- [Vellaro API](https://docs.vellaro.io/introduction.md): Il motore e-commerce API-first. Costruisci storefront, app mobile e automazioni AI su Vellaro.
- [Quickstart](https://docs.vellaro.io/quickstart.md): La tua prima chiamata alla Storefront API in meno di un minuto.
- [Webhook](https://docs.vellaro.io/webhooks.md): Ricevi eventi del negozio in tempo reale sul tuo endpoint.

## OpenAPI Specs

- [openapi](https://api.vellaro.io/openapi.json)