REST API
The REST API lets you read and update your Assemblified raw materialsRaw materialThe atomic component of a BOM or sub-assembly. Two flavors: a Shopify-linked variant (inventory tracked in Shopify) or a virtual material (DO-side inventory only). Both kinds appear in the same component picker and are consumed identically when a BOM fires — except virtual materials never trigger a Shopify call.
Read more →
— and read your bills of materialsBill of MaterialsA bill of materials tells Assemblified how to build one unit of a finished good. When a customer orders the finished-good variant, Assemblified deducts the right component quantities from inventory automatically.
Read more →
with their fully hydrated recipes and computed max-buildable — over plain HTTP: GET or PATCH a URL, get JSON back, without speaking MCP or writing code-mode programs. It’s the same data and the same asmk_ keys as AI / Agent access, exposed as ordinary REST resources.
Base URL
Section titled “Base URL”https://assemblified.com/api/v1A first request
Section titled “A first request”Authenticate with an asmk_ API key (see Authentication):
curl -s -H "Authorization: Bearer $ASMK_TOKEN" \ "https://assemblified.com/api/v1/raw-materials?pageSize=5"Every successful response is wrapped in a small envelope:
{ "data": { "items": [ /* … */ ], "totalCount": 42, "page": 1, "pageSize": 5, "totalPages": 9, "availableVendors": [ /* … */ ] }, "meta": { "requestId": "…", "apiVersion": "1.1" }}What you can do
Section titled “What you can do”How it relates to AI / Agent access
Section titled “How it relates to AI / Agent access”The REST API and the Agent access surface share the same asmk_ API keys, the same read/write scopes, and the same per-shop rate limit, and are backed by the same operations — a change made over REST is exactly the change the app UI or an AI assistant would make. If you already use Agent access, your keys work here unchanged (REST additionally requires the Enhanced plan).