Getting started

1. Read a public supply guide

This endpoint needs no account or token. Search the fabric-brand guide for Moda and return one result:

curl --fail-with-body --silent --show-error \
  'https://www.quiltlab.co/api/v1/supplies?category=fabric-brands&query=moda&limit=1'

A successful request returns HTTP 200 with success and data. This excerpt is from a verified response; item descriptions and retailer fields are omitted for readability:

{
  "success": true,
  "data": {
    "category": "fabric-brands",
    "items": [{
      "slug": "moda-fabrics-bella-solids",
      "name": "Moda Fabrics Bella Solids",
      "guideUrl": "https://www.quiltlab.co/quilting-fabrics/brands/moda-fabrics-bella-solids"
    }],
    "totalMatching": 1,
    "truncated": false
  }
}

Guide content can change. See the reference for all response fields and supported categories.

2. Connect your account

Follow Clerk OAuth discovery and authorization to obtain an access token, then confirm authentication. Set QUILTLAB_ACCESS_TOKEN in your shell to your OAuth access token; keep it private.

curl --fail-with-body --silent --show-error \
  -H "Authorization: Bearer $QUILTLAB_ACCESS_TOKEN" \
  'https://www.quiltlab.co/api/v1/auth/me'

The authenticated response has this shape (the user ID below is illustrative):

{"success":true,"data":{"authenticated":true,"userId":"user_abc123"}}

3. Start a design

List your projects, quilts, and blocks, or create an empty project or block stub. Creates return a url for opening the project or editor; detailed editing happens in QuiltLab. Create operations are not replay-safe, so do not blindly retry a timed-out write.

Use the Arazzo workflows for the published sequences. Prefer an agent client? Connect over MCP to use the same operations as tools.