Machine identity API Org keys · devices · plan limits

Org keys for fleets of devices and agents.

Wire a single org-level key into your stack. Agents register themselves, you enforce device limits by plan, and we keep the bookkeeping in one place.

Built for small teams and AI agents – one org key per customer, unlimited internal services.

Checking system status…

POST /api/v1/devices/register · plan limits enforced on every call

Getting started

Step 1: create or load an org key · Step 2: call /devices/register.

Step 1 of 2

Step 2 – Register a device with this org key

Next: open the dashboard to see devices and plan limits.

You can always generate another org key later from the dashboard.

If you upgraded to a paid plan and lose access to your org key, use the "Recover org key by email" button in the dashboard’s Billing & plan changes card to get it back via magic link.

Plans & device caps

Device limits enforced on registration and validation.

Every time your agent calls /devices/register or /devices/validate, we look up the org's plan and device count. If they're at the cap, new devices are blocked until they upgrade or revoke something.

Org key & project wiring

One key per customer, app, or environment.

You can treat an org key as a customer, a project, or an environment. Most teams wire a single org key into a cluster of services and let agents register themselves from wherever they run.

Pseudo-config in your agent

// agent-config.json
{
  "machineIdOrgKey": "org_your_key_here",
  "agentId": "agent-01",
  "registerUrl": "https://machineid.io/api/v1/devices/register",
  "validateUrl": "https://machineid.io/api/v1/devices/validate"
}

API reference

Simple JSON endpoints for devices and plans.

The API is intentionally small: create an org, register devices, validate devices, and list them. You can explore all endpoints, status codes, and examples in the docs.