API reference · beta

Build production workflows into your tools.

Use the StitchGrid API to connect products, factories, samples, purchase orders, inventory, and production updates. The API is currently available to approved Produce and Network customers.

BASE URLhttps://stitchgrid.com/api

Authentication

Create an API key in workspace settings. Send it as a bearer token with every request. Treat keys like passwords and never put them in browser or mobile code.

curl https://stitchgrid.com/api/factories \
  -H "Authorization: Bearer sg_live_your_key" \
  -H "Content-Type: application/json"

Keys inherit their organization’s access. Revoke a key immediately if it is exposed.

Core resources

All JSON responses are scoped to the organization associated with the API key. Write access and stable versioning are being rolled out to approved integrations.

GET/factories

List matched and connected factories.

GET/samples

List samples and their current approval state.

GET/purchase-orders

List production orders, milestones, and delivery status.

GET/inventory/items

List SKUs, stock position, and reorder settings.

GET/inventory/risks

List stockout risks and suggested replenishment actions.

Webhooks

Webhooks are enabled per integration during onboarding. Verify the signature before processing a delivery and return a 2xx response within 10 seconds. Common events include sample.updated, purchase_order.updated, milestone.completed, and shipment.updated.

Errors and limits

Errors use standard HTTP status codes and return a JSON object with an error message. A 401 means the key is missing or invalid, 403 means the key lacks access, 429 means the request limit was reached, and 5xx means StitchGrid could not complete the request.

{
  "error": "Resource not found",
  "requestId": "req_01K..."
}

Integration support

The public API is in beta. Contact support@stitchgrid.com before building against a new resource so we can confirm access, event coverage, and versioning.