Skip to content
Public API — beta. v1 reads all materials but modifies virtual materials only — Shopify-managed materials are read-only. The response schema may change without notice while the API is in beta.

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 → 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.

https://assemblified.com/api/v1

Authenticate with an asmk_ API key (see Authentication):

Terminal window
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.0" }
}

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).