← Developers

AI Quickstart

Machine-friendly workflow for Claude / Cursor. Principle: AI controls presentation. Ettajer controls commerce.

1. Authenticate — OAuth (docs) or API key from /dashboard/developer. Send Authorization: Bearer ….
2. GET /api/v1/context — understand the store (branding, products, collections, themes).
3. GET /api/v1/themes/schema — learn allowed sections, settings, and reference shapes.
4. POST /api/v1/themes — create a private draft ({ "name": "Atlas Editorial", "provider": "claude" }).
5. POST /api/v1/themes/:id/pages — optional custom pages (not cart / checkout / products).
6. POST /api/v1/themes/:id/sections — add hero, product-grid with real productIds, etc.
7. Preview — POST /api/v1/themes/:id/preview-token returns a short-lived signed URL (/store/{slug}?preview=true&previewThemeId=…&previewToken=…). Same storefront renderer on home, product, collection, and custom pages; real catalog/cart/checkout. Merchant session also works without a token.
8. Merchant Customize opens /dashboard/themes/editor?themeId=… and hydrates the visual editor from the draft.
9. POST /api/v1/themes/:id/publish — requires themes:publish. Transactional. Cart/checkout stay Ettajer.

MCP

Same auth on POST /api/v1/mcp. Prefer tools get_context → get_theme_schema → create_theme → create_section → preview_theme → publish_theme.

Full docs: llms-full.txt