Quickstart

This guide walks you through listing the machines in one of your factories — the "Hello, World" of the Factory OS API.

Prerequisites

• A Xentr account with at least one organization and factory
• A Supabase access token (see Authentication)
• curl or any HTTP client

1. Grab your access token

Sign in to the dashboard at app.xentr.ai, open your browser devtools, and copy the Supabase access token from local storage or your sb-*-auth-token cookie.

For long-lived programmatic access, create a service role token in your organization settings (coming soon).

2. Identify your factory slug

Path params use factory slugs, not UUIDs. Find your slug in the Xentr dashboard URL:

https://app.xentr.ai/[org-slug]/factories/[factory-slug]
                                       ^^^^^^^^^^^^
                                       factory slug

3. List machines

curl https://api.xentr.ai/api/factories/[factory-slug]/machines \
  -H "Authorization: Bearer $XENTR_TOKEN"

const res = await fetch(
  'https://api.xentr.ai/api/factories/[factory-slug]/machines',
  { headers: { Authorization: `Bearer ${process.env.XENTR_TOKEN}` } },
);
const machines = await res.json();
console.log(machines);

import os, requests

res = requests.get(
    "https://api.xentr.ai/api/factories/[factory-slug]/machines",
    headers={"Authorization": f"Bearer {os.environ['XENTR_TOKEN']}"},
)
print(res.json())

You'll get back an array of machines scoped to that factory:

[
  {
    "id": "a1b2c3d4-...",
    "code": "CNC-001",
    "name": "Haas VF-2",
    "factoryId": "...",
    "status": "running"
  }
]

4. What next?