Skip to content

Workflows

A workflow is the ordered sequence of Bagisto API calls a client fires to complete a feature — and which call depends on which. Each page shows the dependency flow as a diagram, then links the endpoint page backing every step. Bagisto has no server-side workflow primitive; "workflow" here means the client call-sequence, framework-agnostic.

How to read a workflow page

Every flow page uses the same blocks:

  1. Agent-ask inputs — values the agent must ask you for. Today that is the server URL and the storefront key.
  2. Prerequisites — what must exist first (key, cart token, auth).
  3. Dependency diagram — a Mermaid flow you can follow top to bottom.
  4. Ordered call table — step, endpoint (linked), what it depends on.
  5. End-to-end example — the happy path, REST and GraphQL.
  6. Customize — link to extend the flow.

Shop

WorkflowWhat it builds
Build a StorefrontCatalog, cart, and checkout end to end
CartGuest/customer cart, add/update items, coupons, merge on login
CheckoutAddresses, shipping, payment methods, place order

Admin

WorkflowWhat it builds
Build an Admin DashboardThe complete blueprint — every admin menu mapped to its API
Create-Order FlowPlacing an order for a customer (sequential draft-cart state machine)
Product ManagementCreate/edit products — 7 types, two-step create, image/inventory/price panels
Order Fulfillment ActionsInvoice, ship, refund, cancel — per-order eligibility guards
Customers (Impersonate & GDPR)Impersonation token and GDPR delete/download flows
MarketingPromotions, communications, search & SEO — rule reindex, campaigns, coupons, sitemaps
ConfigurationSlug-scoped store settings via three generic endpoints

Customization

Extending the API itself (adding or changing endpoints) — see Customization.

Building with an AI agent?

See Build with AI for the llms.txt index, the agent skills, and the optional docs MCP server.

Released under the MIT License.