{ "info": { "_postman_id": "5b6a1e2c-0000-4000-8000-000000000001", "name": "Atlas Labs API", "description": "Atlas Labs — a fictional, anonymous 30-minute API sandbox (Factory + Head Office). Run 'Create a sandbox' first: it stores both keys into the collection variables the other folders' Bearer auth reads. Generated from the API's own OpenAPI 3.1 document — see templates/README.md.", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json" }, "variable": [ { "key": "baseUrl", "value": "https://automationatlas.io/labs/api/v1", "type": "string" }, { "key": "factoryKey", "value": "", "type": "string" }, { "key": "officeKey", "value": "", "type": "string" }, { "key": "sandboxId", "value": "", "type": "string" } ], "item": [ { "name": "Sandbox", "item": [ { "name": "API index", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/", "host": [ "{{baseUrl}}" ], "path": [] }, "description": "Self-describing index (PLAN §4.2): what Atlas Labs is, how to start, key prefixes and headers, a create-sandbox example, links to OpenAPI, docs, llms files and MCP (with the labs://guide resource), and next_actions. Fictional simulation." } }, { "name": "List events", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/events?after_seq=&wait=&system=", "host": [ "{{baseUrl}}" ], "path": [ "events" ], "query": [ { "key": "after_seq", "value": "", "disabled": true }, { "key": "wait", "value": "", "disabled": true }, { "key": "system", "value": "", "disabled": true } ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "description": "Cursor feed of this fictional sandbox's events, seq-ascending after after_seq. Optional wait (≤25 s) long-polls. Either a Factory or Head Office key. Example: GET /labs/api/v1/events?after_seq=0&wait=0&system=office" } }, { "name": "Health check", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/health", "host": [ "{{baseUrl}}" ], "path": [ "health" ] }, "description": "Liveness probe: status, version, factories open now (as GET /world counts them), the sandbox queue and the load level. Every number on this payload is from a fictional simulation." } }, { "name": "List missions", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/missions", "host": [ "{{baseUrl}}" ], "path": [ "missions" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "description": "Ordered missions for this fictional sandbox, detected from events. Either a Factory or Head Office key. Example: GET /labs/api/v1/missions" } }, { "name": "OpenAPI 3.0 document", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/openapi-3.0.json", "host": [ "{{baseUrl}}" ], "path": [ "openapi-3.0.json" ] }, "description": "The same operations as an OpenAPI 3.0.3 document, for tools that do not read 3.1. No key needed." } }, { "name": "OpenAPI 3.1 document", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/openapi.json", "host": [ "{{baseUrl}}" ], "path": [ "openapi.json" ] }, "description": "This API described as an OpenAPI 3.1 document, generated from the live route schemas. No key needed." } }, { "name": "Check a queue ticket", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/queue/ticket_example01", "host": [ "{{baseUrl}}" ], "path": [ "queue", "ticket_example01" ] }, "description": "Poll a sandbox queue ticket. Ready tickets return the 201 body once." } }, { "name": "End the sandbox", "request": { "method": "DELETE", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" } ], "url": { "raw": "{{baseUrl}}/sandbox", "host": [ "{{baseUrl}}" ], "path": [ "sandbox" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "description": "End this fictional sandbox early. Either a Factory or Head Office key." } }, { "name": "Get sandbox status", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/sandbox", "host": [ "{{baseUrl}}" ], "path": [ "sandbox" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "description": "Status of this fictional sandbox: expiry, sim date, pace, automation and bridge settings. Either a Factory or Head Office key." } }, { "name": "Update sandbox settings", "request": { "method": "PATCH", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" } ], "url": { "raw": "{{baseUrl}}/sandbox", "host": [ "{{baseUrl}}" ], "path": [ "sandbox" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "description": "Change this fictional sandbox's automation (`automate`), bridge mode (`bridge`) or pace (`pace`). Either a Factory or Head Office key." } }, { "name": "Extend the sandbox", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" } ], "url": { "raw": "{{baseUrl}}/sandbox/extend", "host": [ "{{baseUrl}}" ], "path": [ "sandbox", "extend" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "description": "Add time to this fictional sandbox. Only allowed when ten minutes or fewer remain, and a limited number of times (400 extend_too_early, 409 extend_exhausted). Either a Factory or Head Office key." } }, { "name": "Get the sandbox receipt", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/sandbox/receipt", "host": [ "{{baseUrl}}" ], "path": [ "sandbox", "receipt" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "description": "A summary receipt for this fictional sandbox: atlases in stock and achievements earned. Either a Factory or Head Office key." } }, { "name": "Reset the sandbox", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" } ], "url": { "raw": "{{baseUrl}}/sandbox/reset", "host": [ "{{baseUrl}}" ], "path": [ "sandbox", "reset" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "description": "Return this fictional sandbox to its starting state. A limited number of resets is allowed (409 reset_exhausted). Either a Factory or Head Office key." } }, { "name": "Advance the simulation", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" } ], "url": { "raw": "{{baseUrl}}/sandbox/tick", "host": [ "{{baseUrl}}" ], "path": [ "sandbox", "tick" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "description": "Advance a manual-pace fictional sandbox by `days` sim days (1 to 7). Only for `pace: manual` (409 tick_not_manual otherwise). Either a Factory or Head Office key." } }, { "name": "Create a sandbox", "request": { "method": "POST", "header": [ { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/sandboxes", "host": [ "{{baseUrl}}" ], "path": [ "sandboxes" ] }, "body": { "mode": "raw", "raw": "{\n \"preset\": \"standard\",\n \"pace\": \"manual\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Create a 30-minute fictional sandbox. Keys are shown once. Without a body continent, the team comes from the visitor's country (only the continent is stored), or is assigned when the country is unknown; AN only by choice. Simulation: true. Errors: 503 feature_disabled (sandbox creation paused by the operator, or by load shedding — retry after Retry-After), 202 (queued; see PLAN §3.1). When the operator has switched on first-party proof-of-work (off by default), this returns 428 pow_required with {challenge, difficulty, expires_at}; retry with header `Atlas-PoW: .` where SHA-256(challenge + nonce) has `difficulty` leading zero bits. See docs/POW.md for TypeScript and Python solvers." }, "event": [ { "listen": "test", "script": { "type": "text/javascript", "exec": [ "const status = pm.response.code;", "pm.test('sandbox created or queued', () => [200, 201, 202].includes(status));", "const body = pm.response.json();", "const data = body && body.data ? body.data : {};", "if (data.factory_key) {", " pm.collectionVariables.set('factoryKey', data.factory_key);", "}", "if (data.office_key) {", " pm.collectionVariables.set('officeKey', data.office_key);", "}", "if (data.sandbox_id) {", " pm.collectionVariables.set('sandboxId', data.sandbox_id);", "}" ] } } ] }, { "name": "Stream events", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/stream?system=", "host": [ "{{baseUrl}}" ], "path": [ "stream" ], "query": [ { "key": "system", "value": "", "disabled": true } ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "description": "Server-sent events for this fictional sandbox. Resume with Last-Event-ID (seq). Keepalive comment every 15 s. Cap 3 streams per sandbox (4th → 429 sse_limit). Either a Factory or Head Office key. Example: GET /labs/api/v1/stream" } }, { "name": "Swagger 2.0 document", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/swagger-2.0.json", "host": [ "{{baseUrl}}" ], "path": [ "swagger-2.0.json" ] }, "description": "The same operations as a Swagger 2.0 document, the format Power Automate custom connectors import. No key needed." } } ] }, { "name": "Head Office", "item": [ { "name": "Get the Head Office overview", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/office", "host": [ "{{baseUrl}}" ], "path": [ "office" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "description": "Cash, receivables, payables and open approvals for this fictional Head Office simulation. Example: GET /labs/api/v1/office" } }, { "name": "List HR candidates", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/office/candidates?cursor=&limit=&updated_since=2026-09-17T12:00:00Z", "host": [ "{{baseUrl}}" ], "path": [ "office", "candidates" ], "query": [ { "key": "cursor", "value": "", "disabled": true }, { "key": "limit", "value": "", "disabled": true }, { "key": "updated_since", "value": "2026-09-17T12:00:00Z", "description": "ISO-8601 date or timestamp", "disabled": true } ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "description": "HR candidate pool for this fictional Head Office simulation. 404 module_disabled when HR is off. Example: GET /labs/api/v1/office/candidates" } }, { "name": "List contracts on offer", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/office/contracts?cursor=&limit=&updated_since=2026-09-17T12:00:00Z", "host": [ "{{baseUrl}}" ], "path": [ "office", "contracts" ], "query": [ { "key": "cursor", "value": "", "disabled": true }, { "key": "limit", "value": "", "disabled": true }, { "key": "updated_since", "value": "2026-09-17T12:00:00Z", "description": "ISO-8601 date or timestamp", "disabled": true } ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "description": "Your contract lot offers in this fictional Head Office simulation, newest first. Each lot is yours alone; accept within 3 sim days and deliver within 7. Example: GET /labs/api/v1/office/contracts" } }, { "name": "Accept a contract", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" } ], "url": { "raw": "{{baseUrl}}/office/contracts/lot_example01/accept", "host": [ "{{baseUrl}}" ], "path": [ "office", "contracts", "lot_example01", "accept" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "description": "Accept a contract lot offer in this fictional Head Office simulation. 409 lot_expired, 409 already_decided. Example: POST /labs/api/v1/office/contracts/lot_xxx/accept" } }, { "name": "Decline a contract", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/office/contracts/lot_example01/decline", "host": [ "{{baseUrl}}" ], "path": [ "office", "contracts", "lot_example01", "decline" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"reason\": \"capacity\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Decline a contract lot offer in this fictional Head Office simulation; the lot is re-offered fairly to another factory. Example: {\"reason\":\"capacity\"}" } }, { "name": "List customer invoices", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/office/customer-invoices?cursor=&limit=&updated_since=2026-09-17T12:00:00Z", "host": [ "{{baseUrl}}" ], "path": [ "office", "customer-invoices" ], "query": [ { "key": "cursor", "value": "", "disabled": true }, { "key": "limit", "value": "", "disabled": true }, { "key": "updated_since", "value": "2026-09-17T12:00:00Z", "description": "ISO-8601 date or timestamp", "disabled": true } ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "description": "Customer invoices in this fictional Head Office simulation. Example: GET /labs/api/v1/office/customer-invoices" } }, { "name": "List customers", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/office/customers?cursor=&limit=&updated_since=2026-09-17T12:00:00Z", "host": [ "{{baseUrl}}" ], "path": [ "office", "customers" ], "query": [ { "key": "cursor", "value": "", "disabled": true }, { "key": "limit", "value": "", "disabled": true }, { "key": "updated_since", "value": "2026-09-17T12:00:00Z", "description": "ISO-8601 date or timestamp", "disabled": true } ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "description": "Fictional bookshop customers in this Head Office simulation. Example: GET /labs/api/v1/office/customers" } }, { "name": "Create a customer", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/office/customers", "host": [ "{{baseUrl}}" ], "path": [ "office", "customers" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"Harbour Books\",\n \"external_id\": \"hb-1\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Create or upsert a fictional customer. Example: {\"name\":\"Harbour Books\",\"external_id\":\"hb-1\"}" } }, { "name": "Update a customer", "request": { "method": "PATCH", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/office/customers/cus_example01", "host": [ "{{baseUrl}}" ], "path": [ "office", "customers", "cus_example01" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"name\": \"Harbour Books Ltd\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Patch a fictional customer. Example: {\"name\":\"Harbour Books Ltd\"}" } }, { "name": "List employees", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/office/employees?cursor=&limit=&updated_since=2026-09-17T12:00:00Z", "host": [ "{{baseUrl}}" ], "path": [ "office", "employees" ], "query": [ { "key": "cursor", "value": "", "disabled": true }, { "key": "limit", "value": "", "disabled": true }, { "key": "updated_since", "value": "2026-09-17T12:00:00Z", "description": "ISO-8601 date or timestamp", "disabled": true } ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "description": "HR roster for this fictional Head Office simulation. 404 module_disabled when HR is off. Example: GET /labs/api/v1/office/employees" } }, { "name": "Hire a candidate", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/office/employees", "host": [ "{{baseUrl}}" ], "path": [ "office", "employees" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"candidate_id\": \"cand_xxx\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Hire a candidate in this fictional Head Office simulation. Starts 1-2 sim days later. Example: {\"candidate_id\":\"cand_xxx\"}" } }, { "name": "Dismiss an employee", "request": { "method": "DELETE", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" } ], "url": { "raw": "{{baseUrl}}/office/employees/emp_example01", "host": [ "{{baseUrl}}" ], "path": [ "office", "employees", "emp_example01" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "description": "Let an employee go in this fictional Head Office simulation. Example: DELETE /labs/api/v1/office/employees/emp_xxx" } }, { "name": "List goods receipts", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/office/goods-receipts?cursor=&limit=&updated_since=2026-09-17T12:00:00Z", "host": [ "{{baseUrl}}" ], "path": [ "office", "goods-receipts" ], "query": [ { "key": "cursor", "value": "", "disabled": true }, { "key": "limit", "value": "", "disabled": true }, { "key": "updated_since", "value": "2026-09-17T12:00:00Z", "description": "ISO-8601 date or timestamp", "disabled": true } ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "description": "Head Office goods receipts in this fictional simulation. Example: GET /labs/api/v1/office/goods-receipts" } }, { "name": "Record a goods receipt", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/office/goods-receipts", "host": [ "{{baseUrl}}" ], "path": [ "office", "goods-receipts" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"goods_receipt_id\": \"grn_xxx\",\n \"purchase_order_id\": \"po_xxx\",\n \"quantity_received\": 4000\n}", "options": { "raw": { "language": "json" } } }, "description": "Bridge a Factory goods receipt into Head Office in this fictional simulation. Example: {\"goods_receipt_id\":\"grn_xxx\",\"purchase_order_id\":\"po_xxx\",\"quantity_received\":4000}" } }, { "name": "List leave requests", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/office/leave-requests?cursor=&limit=&updated_since=2026-09-17T12:00:00Z", "host": [ "{{baseUrl}}" ], "path": [ "office", "leave-requests" ], "query": [ { "key": "cursor", "value": "", "disabled": true }, { "key": "limit", "value": "", "disabled": true }, { "key": "updated_since", "value": "2026-09-17T12:00:00Z", "description": "ISO-8601 date or timestamp", "disabled": true } ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "description": "HR leave requests for this fictional Head Office simulation. 404 module_disabled when HR is off. Example: GET /labs/api/v1/office/leave-requests" } }, { "name": "Approve a leave request", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" } ], "url": { "raw": "{{baseUrl}}/office/leave-requests/lv_example01/approve", "host": [ "{{baseUrl}}" ], "path": [ "office", "leave-requests", "lv_example01", "approve" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "description": "Approve a leave request in this fictional Head Office simulation. Example: POST /labs/api/v1/office/leave-requests/lv_xxx/approve" } }, { "name": "Deny a leave request", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" } ], "url": { "raw": "{{baseUrl}}/office/leave-requests/lv_example01/deny", "host": [ "{{baseUrl}}" ], "path": [ "office", "leave-requests", "lv_example01", "deny" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "description": "Deny a leave request in this fictional Head Office simulation. Example: POST /labs/api/v1/office/leave-requests/lv_xxx/deny" } }, { "name": "List ledger entries", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/office/ledger?cursor=&limit=&updated_since=2026-09-17T12:00:00Z", "host": [ "{{baseUrl}}" ], "path": [ "office", "ledger" ], "query": [ { "key": "cursor", "value": "", "disabled": true }, { "key": "limit", "value": "", "disabled": true }, { "key": "updated_since", "value": "2026-09-17T12:00:00Z", "description": "ISO-8601 date or timestamp", "disabled": true } ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "description": "Ledger entries in this fictional Head Office simulation. Example: GET /labs/api/v1/office/ledger" } }, { "name": "Get spot market prices", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/office/market", "host": [ "{{baseUrl}}" ], "path": [ "office", "market" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "description": "Spot prices for your continent on your sim date in this fictional Head Office simulation: buy paper or ink (per 1,000 units), sell atlases (capped per sim day). Example: GET /labs/api/v1/office/market" } }, { "name": "Trade on the spot market", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/office/market", "host": [ "{{baseUrl}}" ], "path": [ "office", "market" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"side\": \"buy\",\n \"item\": \"paper\",\n \"quantity\": 2000\n}", "options": { "raw": { "language": "json" } } }, "description": "Trade on the fictional spot market. Buys arrive in Factory stock on the next tick; sells are capped per sim day. 402 insufficient_funds, 409 insufficient_stock, 409 sell_cap_reached, 409 warehouse_full. Idempotency-Key required. Example: {\"side\":\"buy\",\"item\":\"paper\",\"quantity\":2000}" } }, { "name": "List payroll runs", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/office/payroll-runs?cursor=&limit=&updated_since=2026-09-17T12:00:00Z", "host": [ "{{baseUrl}}" ], "path": [ "office", "payroll-runs" ], "query": [ { "key": "cursor", "value": "", "disabled": true }, { "key": "limit", "value": "", "disabled": true }, { "key": "updated_since", "value": "2026-09-17T12:00:00Z", "description": "ISO-8601 date or timestamp", "disabled": true } ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "description": "HR payroll runs for this fictional Head Office simulation. 404 module_disabled when HR is off. Example: GET /labs/api/v1/office/payroll-runs" } }, { "name": "Run payroll", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" } ], "url": { "raw": "{{baseUrl}}/office/payroll-runs", "host": [ "{{baseUrl}}" ], "path": [ "office", "payroll-runs" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "description": "Pay the oldest outstanding payroll run in this fictional Head Office simulation (HR). 422 timesheets_missing, 402 insufficient_funds. Example: POST /labs/api/v1/office/payroll-runs" } }, { "name": "Check a Head Office key", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/office/ping", "host": [ "{{baseUrl}}" ], "path": [ "office", "ping" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "description": "Confirms that a Head Office key (`lab_off_...`) is valid and returns the system and sandbox ID it belongs to. A Factory key gets 403 wrong_system." } }, { "name": "Get profit and loss", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/office/pnl", "host": [ "{{baseUrl}}" ], "path": [ "office", "pnl" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "description": "P&L rollup by sim week for this fictional Head Office simulation. Example: GET /labs/api/v1/office/pnl" } }, { "name": "List purchase orders", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/office/purchase-orders?cursor=&limit=&updated_since=2026-09-17T12:00:00Z", "host": [ "{{baseUrl}}" ], "path": [ "office", "purchase-orders" ], "query": [ { "key": "cursor", "value": "", "disabled": true }, { "key": "limit", "value": "", "disabled": true }, { "key": "updated_since", "value": "2026-09-17T12:00:00Z", "description": "ISO-8601 date or timestamp", "disabled": true } ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "description": "Purchase orders in this fictional Head Office simulation. Example: GET /labs/api/v1/office/purchase-orders" } }, { "name": "Create a purchase order", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/office/purchase-orders", "host": [ "{{baseUrl}}" ], "path": [ "office", "purchase-orders" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"quote_id\": \"qt_xxx\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Create a purchase order from a quote in this fictional Head Office simulation. Example: {\"quote_id\":\"qt_xxx\"}" } }, { "name": "Approve a purchase order", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" } ], "url": { "raw": "{{baseUrl}}/office/purchase-orders/po_example01/approve", "host": [ "{{baseUrl}}" ], "path": [ "office", "purchase-orders", "po_example01", "approve" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "description": "Approve a pending purchase order in this fictional Head Office simulation. Example: POST /labs/api/v1/office/purchase-orders/po_xxx/approve" } }, { "name": "Create a quote", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/office/quotes", "host": [ "{{baseUrl}}" ], "path": [ "office", "quotes" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"supplier_id\": \"sup_xxx\",\n \"material\": \"paper\",\n \"quantity\": 5000\n}", "options": { "raw": { "language": "json" } } }, "description": "Request a quote in this fictional Head Office simulation. Example: {\"supplier_id\":\"sup_xxx\",\"material\":\"paper\",\"quantity\":5000}" } }, { "name": "List Head Office requisitions", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/office/requisitions?cursor=&limit=&updated_since=2026-09-17T12:00:00Z", "host": [ "{{baseUrl}}" ], "path": [ "office", "requisitions" ], "query": [ { "key": "cursor", "value": "", "disabled": true }, { "key": "limit", "value": "", "disabled": true }, { "key": "updated_since", "value": "2026-09-17T12:00:00Z", "description": "ISO-8601 date or timestamp", "disabled": true } ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "description": "Factory requisitions received by this fictional Head Office simulation. Example: GET /labs/api/v1/office/requisitions" } }, { "name": "Send a requisition to the Factory", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/office/requisitions", "host": [ "{{baseUrl}}" ], "path": [ "office", "requisitions" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"factory_requisition_id\": \"req_xxx\",\n \"material\": \"paper\",\n \"quantity\": 5000,\n \"needed_by\": 4\n}", "options": { "raw": { "language": "json" } } }, "description": "Bridge a Factory requisition into Head Office in this fictional simulation. Example: {\"factory_requisition_id\":\"req_xxx\",\"material\":\"paper\",\"quantity\":5000,\"needed_by\":4}" } }, { "name": "Approve a requisition", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" } ], "url": { "raw": "{{baseUrl}}/office/requisitions/hreq_example01/approve", "host": [ "{{baseUrl}}" ], "path": [ "office", "requisitions", "hreq_example01", "approve" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "description": "Approve a requisition in this fictional Head Office simulation. Example: POST /labs/api/v1/office/requisitions/hreq_xxx/approve" } }, { "name": "Reject a requisition", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" } ], "url": { "raw": "{{baseUrl}}/office/requisitions/hreq_example01/reject", "host": [ "{{baseUrl}}" ], "path": [ "office", "requisitions", "hreq_example01", "reject" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "description": "Reject a requisition in this fictional Head Office simulation. Example: POST /labs/api/v1/office/requisitions/hreq_xxx/reject" } }, { "name": "List sales orders", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/office/sales-orders?cursor=&limit=&updated_since=2026-09-17T12:00:00Z", "host": [ "{{baseUrl}}" ], "path": [ "office", "sales-orders" ], "query": [ { "key": "cursor", "value": "", "disabled": true }, { "key": "limit", "value": "", "disabled": true }, { "key": "updated_since", "value": "2026-09-17T12:00:00Z", "description": "ISO-8601 date or timestamp", "disabled": true } ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "description": "Sales orders in this fictional Head Office simulation. Example: GET /labs/api/v1/office/sales-orders" } }, { "name": "Create a sales order", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/office/sales-orders", "host": [ "{{baseUrl}}" ], "path": [ "office", "sales-orders" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"customer_id\": \"cus_xxx\",\n \"quantity\": 8\n}", "options": { "raw": { "language": "json" } } }, "description": "Inject demand into this fictional Head Office simulation. Example: {\"customer_id\":\"cus_xxx\",\"quantity\":8}" } }, { "name": "Get a sales order", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/office/sales-orders/so_example01", "host": [ "{{baseUrl}}" ], "path": [ "office", "sales-orders", "so_example01" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "description": "A single sales order in this fictional Head Office simulation. Example: GET /labs/api/v1/office/sales-orders/so_xxx" } }, { "name": "Accept a sales order", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" } ], "url": { "raw": "{{baseUrl}}/office/sales-orders/so_example01/accept", "host": [ "{{baseUrl}}" ], "path": [ "office", "sales-orders", "so_example01", "accept" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "description": "Accept a sales order in this fictional Head Office simulation. Returns the sales order row; with bridge: auto the Factory work order is made in the same call, so the row comes back in_production with bridged_work_order_id set. Example: POST /labs/api/v1/office/sales-orders/so_xxx/accept" } }, { "name": "Decline a sales order", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/office/sales-orders/so_example01/decline", "host": [ "{{baseUrl}}" ], "path": [ "office", "sales-orders", "so_example01", "decline" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"reason\": \"capacity\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Decline a sales order in this fictional Head Office simulation. Example: {\"reason\":\"capacity\"}" } }, { "name": "List shipments", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/office/shipments?cursor=&limit=&updated_since=2026-09-17T12:00:00Z", "host": [ "{{baseUrl}}" ], "path": [ "office", "shipments" ], "query": [ { "key": "cursor", "value": "", "disabled": true }, { "key": "limit", "value": "", "disabled": true }, { "key": "updated_since", "value": "2026-09-17T12:00:00Z", "description": "ISO-8601 date or timestamp", "disabled": true } ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "description": "Head Office shipments in this fictional simulation. Example: GET /labs/api/v1/office/shipments" } }, { "name": "Record a shipment to a customer", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/office/shipments", "host": [ "{{baseUrl}}" ], "path": [ "office", "shipments" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"shipment_id\": \"shp_xxx\",\n \"sales_order_id\": \"so_xxx\",\n \"quantity\": 10\n}", "options": { "raw": { "language": "json" } } }, "description": "Bridge a Factory shipment into Head Office and raise a customer invoice in this fictional simulation. Example: {\"shipment_id\":\"shp_xxx\",\"sales_order_id\":\"so_xxx\",\"quantity\":10}" } }, { "name": "List supplier invoices", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/office/supplier-invoices?cursor=&limit=&updated_since=2026-09-17T12:00:00Z", "host": [ "{{baseUrl}}" ], "path": [ "office", "supplier-invoices" ], "query": [ { "key": "cursor", "value": "", "disabled": true }, { "key": "limit", "value": "", "disabled": true }, { "key": "updated_since", "value": "2026-09-17T12:00:00Z", "description": "ISO-8601 date or timestamp", "disabled": true } ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "description": "Supplier invoices in this fictional Head Office simulation. Example: GET /labs/api/v1/office/supplier-invoices" } }, { "name": "Pay a supplier invoice", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" } ], "url": { "raw": "{{baseUrl}}/office/supplier-invoices/sinv_example01/pay", "host": [ "{{baseUrl}}" ], "path": [ "office", "supplier-invoices", "sinv_example01", "pay" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "description": "Pay a supplier invoice in this fictional Head Office simulation. Query override=true or 1 pays despite a three-way mismatch. Example: POST /labs/api/v1/office/supplier-invoices/sinv_xxx/pay" } }, { "name": "List suppliers", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/office/suppliers?cursor=&limit=&updated_since=2026-09-17T12:00:00Z", "host": [ "{{baseUrl}}" ], "path": [ "office", "suppliers" ], "query": [ { "key": "cursor", "value": "", "disabled": true }, { "key": "limit", "value": "", "disabled": true }, { "key": "updated_since", "value": "2026-09-17T12:00:00Z", "description": "ISO-8601 date or timestamp", "disabled": true } ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "description": "Global mills and ink makers for this fictional Head Office simulation. Example: GET /labs/api/v1/office/suppliers" } }, { "name": "Submit a timesheet", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/office/timesheets", "host": [ "{{baseUrl}}" ], "path": [ "office", "timesheets" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"entries\": [\n {\n \"timesheet_id\": \"ts_xxx\",\n \"employee_id\": \"emp_xxx\",\n \"sim_day\": 6,\n \"hours\": 8\n }\n ]\n}", "options": { "raw": { "language": "json" } } }, "description": "Bridge Factory timesheets into Head Office in this fictional simulation (HR). 404 source_not_found, 422 bridge_mismatch, 409 already_bridged. Example: {\"entries\":[{\"timesheet_id\":\"ts_xxx\",\"employee_id\":\"emp_xxx\",\"sim_day\":6,\"hours\":8}]}" } } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] } }, { "name": "Factory", "item": [ { "name": "Get the Factory overview", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/factory", "host": [ "{{baseUrl}}" ], "path": [ "factory" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "description": "Press state, stock and dock of this fictional Factory simulation. Example: GET /labs/api/v1/factory" } }, { "name": "List Factory deliveries", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/factory/deliveries?cursor=&limit=&updated_since=2026-09-17T12:00:00Z", "host": [ "{{baseUrl}}" ], "path": [ "factory", "deliveries" ], "query": [ { "key": "cursor", "value": "", "disabled": true }, { "key": "limit", "value": "", "disabled": true }, { "key": "updated_since", "value": "2026-09-17T12:00:00Z", "description": "ISO-8601 date or timestamp", "disabled": true } ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "description": "Supplier deliveries at the dock in this fictional Factory simulation. Example: GET /labs/api/v1/factory/deliveries" } }, { "name": "Receive a delivery into stock", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/factory/goods-receipts", "host": [ "{{baseUrl}}" ], "path": [ "factory", "goods-receipts" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"delivery_id\": \"dlv_xxx\",\n \"quantity_received\": 4000\n}", "options": { "raw": { "language": "json" } } }, "description": "Record a goods receipt against a dock delivery in this fictional Factory simulation. Example: {\"delivery_id\":\"dlv_xxx\",\"quantity_received\":4000}" } }, { "name": "List Factory stock", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/factory/inventory", "host": [ "{{baseUrl}}" ], "path": [ "factory", "inventory" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "description": "Paper, ink and atlas stock with warehouse caps for this fictional Factory simulation. Example: GET /labs/api/v1/factory/inventory" } }, { "name": "Update reorder points", "request": { "method": "PATCH", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/factory/inventory/reorder-points", "host": [ "{{baseUrl}}" ], "path": [ "factory", "inventory", "reorder-points" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"paper_reorder_point\": 8000,\n \"ink_reorder_point\": 20000\n}", "options": { "raw": { "language": "json" } } }, "description": "Set paper and ink reorder points in this fictional Factory simulation. Example: {\"paper_reorder_point\":8000,\"ink_reorder_point\":20000}" } }, { "name": "Check a Factory key", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/factory/ping", "host": [ "{{baseUrl}}" ], "path": [ "factory", "ping" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "description": "Confirms that a Factory key (`lab_fac_...`) is valid and returns the system and sandbox ID it belongs to. A Head Office key gets 403 wrong_system." } }, { "name": "List print runs", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/factory/print-runs?cursor=&limit=&updated_since=2026-09-17T12:00:00Z", "host": [ "{{baseUrl}}" ], "path": [ "factory", "print-runs" ], "query": [ { "key": "cursor", "value": "", "disabled": true }, { "key": "limit", "value": "", "disabled": true }, { "key": "updated_since", "value": "2026-09-17T12:00:00Z", "description": "ISO-8601 date or timestamp", "disabled": true } ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "description": "Print runs in this fictional Factory simulation. Example: GET /labs/api/v1/factory/print-runs" } }, { "name": "Start a print run", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/factory/print-runs", "host": [ "{{baseUrl}}" ], "path": [ "factory", "print-runs" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"quantity\": 10,\n \"edition\": \"standard\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Start a print run in this fictional Factory simulation. Example: {\"quantity\":10,\"edition\":\"standard\"}" } }, { "name": "Get a print run", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/factory/print-runs/pr_example01", "host": [ "{{baseUrl}}" ], "path": [ "factory", "print-runs", "pr_example01" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "description": "A single print run in this fictional Factory simulation. Example: GET /labs/api/v1/factory/print-runs/pr_xxx" } }, { "name": "List Factory requisitions", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/factory/requisitions?cursor=&limit=&updated_since=2026-09-17T12:00:00Z", "host": [ "{{baseUrl}}" ], "path": [ "factory", "requisitions" ], "query": [ { "key": "cursor", "value": "", "disabled": true }, { "key": "limit", "value": "", "disabled": true }, { "key": "updated_since", "value": "2026-09-17T12:00:00Z", "description": "ISO-8601 date or timestamp", "disabled": true } ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "description": "Material requisitions in this fictional Factory simulation. Example: GET /labs/api/v1/factory/requisitions" } }, { "name": "Raise a requisition", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/factory/requisitions", "host": [ "{{baseUrl}}" ], "path": [ "factory", "requisitions" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"material\": \"paper\",\n \"quantity\": 5000,\n \"needed_by\": 4\n}", "options": { "raw": { "language": "json" } } }, "description": "Open a paper or ink requisition in this fictional Factory simulation. Example: {\"material\":\"paper\",\"quantity\":5000,\"needed_by\":4}" } }, { "name": "List Factory shipments", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/factory/shipments?cursor=&limit=&updated_since=2026-09-17T12:00:00Z", "host": [ "{{baseUrl}}" ], "path": [ "factory", "shipments" ], "query": [ { "key": "cursor", "value": "", "disabled": true }, { "key": "limit", "value": "", "disabled": true }, { "key": "updated_since", "value": "2026-09-17T12:00:00Z", "description": "ISO-8601 date or timestamp", "disabled": true } ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "description": "Shipments in this fictional Factory simulation. Example: GET /labs/api/v1/factory/shipments" } }, { "name": "Ship finished atlases", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/factory/shipments", "host": [ "{{baseUrl}}" ], "path": [ "factory", "shipments" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"work_order_id\": \"wo_xxx\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Ship a ready work order, or deliver atlases against an accepted contract lot (partial deliveries sum; revenue is booked at the lot price), in this fictional Factory simulation. 409 insufficient_stock, 409 lot_expired, 409 lot_not_accepted. Example: {\"work_order_id\":\"wo_xxx\"} or {\"contract_lot_id\":\"lot_xxx\",\"quantity\":50}" } }, { "name": "List Factory timesheets", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/factory/timesheets?cursor=&limit=&updated_since=2026-09-17T12:00:00Z", "host": [ "{{baseUrl}}" ], "path": [ "factory", "timesheets" ], "query": [ { "key": "cursor", "value": "", "disabled": true }, { "key": "limit", "value": "", "disabled": true }, { "key": "updated_since", "value": "2026-09-17T12:00:00Z", "description": "ISO-8601 date or timestamp", "disabled": true } ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "description": "HR: daily hours per employee in this fictional Factory simulation. 404 module_disabled when HR is off. Example: GET /labs/api/v1/factory/timesheets" } }, { "name": "List work orders", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/factory/work-orders?cursor=&limit=&updated_since=2026-09-17T12:00:00Z", "host": [ "{{baseUrl}}" ], "path": [ "factory", "work-orders" ], "query": [ { "key": "cursor", "value": "", "disabled": true }, { "key": "limit", "value": "", "disabled": true }, { "key": "updated_since", "value": "2026-09-17T12:00:00Z", "description": "ISO-8601 date or timestamp", "disabled": true } ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "description": "Work orders in this fictional Factory simulation. Example: GET /labs/api/v1/factory/work-orders" } }, { "name": "Create a work order", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/factory/work-orders", "host": [ "{{baseUrl}}" ], "path": [ "factory", "work-orders" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"sales_order_id\": \"so_xxx\",\n \"quantity\": 10,\n \"due_date\": 5\n}", "options": { "raw": { "language": "json" } } }, "description": "Bridge an accepted sales order into a work order in this fictional Factory simulation. Example: {\"sales_order_id\":\"so_xxx\",\"quantity\":10,\"due_date\":5}" } }, { "name": "Get a work order", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/factory/work-orders/wo_example01", "host": [ "{{baseUrl}}" ], "path": [ "factory", "work-orders", "wo_example01" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "description": "A single work order in this fictional Factory simulation. Example: GET /labs/api/v1/factory/work-orders/wo_xxx" } } ], "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] } }, { "name": "Bridge", "item": [ { "name": "Create a work order", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/factory/work-orders", "host": [ "{{baseUrl}}" ], "path": [ "factory", "work-orders" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"sales_order_id\": \"so_xxx\",\n \"quantity\": 10,\n \"due_date\": 5\n}", "options": { "raw": { "language": "json" } } }, "description": "Bridge an accepted sales order into a work order in this fictional Factory simulation. Example: {\"sales_order_id\":\"so_xxx\",\"quantity\":10,\"due_date\":5}" } }, { "name": "Record a goods receipt", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/office/goods-receipts", "host": [ "{{baseUrl}}" ], "path": [ "office", "goods-receipts" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"goods_receipt_id\": \"grn_xxx\",\n \"purchase_order_id\": \"po_xxx\",\n \"quantity_received\": 4000\n}", "options": { "raw": { "language": "json" } } }, "description": "Bridge a Factory goods receipt into Head Office in this fictional simulation. Example: {\"goods_receipt_id\":\"grn_xxx\",\"purchase_order_id\":\"po_xxx\",\"quantity_received\":4000}" } }, { "name": "Send a requisition to the Factory", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/office/requisitions", "host": [ "{{baseUrl}}" ], "path": [ "office", "requisitions" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"factory_requisition_id\": \"req_xxx\",\n \"material\": \"paper\",\n \"quantity\": 5000,\n \"needed_by\": 4\n}", "options": { "raw": { "language": "json" } } }, "description": "Bridge a Factory requisition into Head Office in this fictional simulation. Example: {\"factory_requisition_id\":\"req_xxx\",\"material\":\"paper\",\"quantity\":5000,\"needed_by\":4}" } }, { "name": "Record a shipment to a customer", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/office/shipments", "host": [ "{{baseUrl}}" ], "path": [ "office", "shipments" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"shipment_id\": \"shp_xxx\",\n \"sales_order_id\": \"so_xxx\",\n \"quantity\": 10\n}", "options": { "raw": { "language": "json" } } }, "description": "Bridge a Factory shipment into Head Office and raise a customer invoice in this fictional simulation. Example: {\"shipment_id\":\"shp_xxx\",\"sales_order_id\":\"so_xxx\",\"quantity\":10}" } }, { "name": "Submit a timesheet", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/office/timesheets", "host": [ "{{baseUrl}}" ], "path": [ "office", "timesheets" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{officeKey}}", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"entries\": [\n {\n \"timesheet_id\": \"ts_xxx\",\n \"employee_id\": \"emp_xxx\",\n \"sim_day\": 6,\n \"hours\": 8\n }\n ]\n}", "options": { "raw": { "language": "json" } } }, "description": "Bridge Factory timesheets into Head Office in this fictional simulation (HR). 404 source_not_found, 422 bridge_mismatch, 409 already_bridged. Example: {\"entries\":[{\"timesheet_id\":\"ts_xxx\",\"employee_id\":\"emp_xxx\",\"sim_day\":6,\"hours\":8}]}" } } ] }, { "name": "Webhooks", "item": [ { "name": "List webhooks", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/webhooks", "host": [ "{{baseUrl}}" ], "path": [ "webhooks" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "description": "Webhook subscriptions of this fictional sandbox (at most 3). Either key. URLs are never returned, only url_host. Example: GET /labs/api/v1/webhooks" } }, { "name": "Create a webhook", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/webhooks", "host": [ "{{baseUrl}}" ], "path": [ "webhooks" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"url\": \"https://hooks.zapier.com/hooks/catch/123456/abcdef/\",\n \"events\": [\n \"office.sales_order.received\"\n ],\n \"description\": \"Zapier: new orders\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Subscribe a public HTTPS URL (port 443) to this fictional sandbox's events. Either key; Idempotency-Key honoured (a replay never repeats the secret). Returns the whsec_ secret once. The subscription is pending_verification until a webhook.test ping gets a 2xx. Errors: 422 webhook_url_rejected (details.reason: scheme_not_https, port_not_allowed, userinfo_not_allowed, hostname_not_public, ip_not_public, denylisted, invalid_url), 422 invalid_event_type, 409 webhook_limit_reached. Event types: office.sales_order.received, office.sales_order.accepted, office.sales_order.declined, office.sales_order.expired, office.requisition.received, office.requisition.approved, office.requisition.rejected, office.purchase_order.created, office.purchase_order.approval_required, office.purchase_order.approved, office.supplier_invoice.received, office.supplier_invoice.paid, office.customer_invoice.created, office.customer_invoice.paid, office.customer_invoice.overdue, office.payment.received, office.payment.overdue, office.goods_receipt.recorded, office.contract_lot.offered, office.contract_lot.accepted, office.contract_lot.declined, office.contract_lot.expired, office.contract_lot.delivered, office.market_trade.executed, factory.work_order.created, factory.work_order.ready, factory.shipment.created, factory.print_run.started, factory.print_run.completed, factory.requisition.created, factory.stock.below_reorder_point, factory.delivery.arrived, factory.goods_receipt.recorded, factory.market_delivery.received, hr.employee.sick, hr.employee.returned, hr.employee.quit, hr.employee.dismissed, hr.employee.hired, hr.leave_request.created, hr.payroll.due, hr.payroll.late, hr.payroll.paid, world.major_order.updated, world.lore_event.started, sandbox.mission.completed, sandbox.achievement.unlocked, sandbox.expiring, sandbox.bankrupt, sandbox.disruption.ended, or \"*\" for all. Deliveries are signed with Standard Webhooks headers (webhook-id, webhook-timestamp, webhook-signature: v1,). For 24 h after rotate-secret (or until the sandbox ends), webhook-signature carries two space-separated values, \"v1, v1,\", so a receiver mid-rotation verifies against either. Retries after 10 s, 60 s and 5 min; 5 consecutive failures disable the subscription. Example: {\"url\":\"https://hooks.zapier.com/hooks/catch/123456/abcdef/\",\"events\":[\"office.sales_order.received\"],\"description\":\"Zapier: new orders\"}" } }, { "name": "Delete a webhook", "request": { "method": "DELETE", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" } ], "url": { "raw": "{{baseUrl}}/webhooks/whk_example01", "host": [ "{{baseUrl}}" ], "path": [ "webhooks", "whk_example01" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "description": "Delete a webhook subscription and its delivery history. Example: DELETE /labs/api/v1/webhooks/whk_01J…" } }, { "name": "Get a webhook", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/webhooks/whk_example01", "host": [ "{{baseUrl}}" ], "path": [ "webhooks", "whk_example01" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "description": "One webhook subscription: status (pending_verification, active, verification_failed, disabled), events, url_host and failure count. Example: GET /labs/api/v1/webhooks/whk_01J…" } }, { "name": "Update a webhook", "request": { "method": "PATCH", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/webhooks/whk_example01", "host": [ "{{baseUrl}}" ], "path": [ "webhooks", "whk_example01" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"enabled\": false\n}", "options": { "raw": { "language": "json" } } }, "description": "Enable, disable or change the events of a webhook subscription. enabled:true on a disabled or failed subscription re-runs the webhook.test verification. Errors: 404 not_found, 422 invalid_event_type, 422 webhook_url_rejected (denylisted). Example: {\"enabled\":false} or {\"events\":[\"*\"]}" } }, { "name": "List webhook deliveries", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/webhooks/whk_example01/deliveries?cursor=&limit=&updated_since=2026-09-17T12:00:00Z", "host": [ "{{baseUrl}}" ], "path": [ "webhooks", "whk_example01", "deliveries" ], "query": [ { "key": "cursor", "value": "", "disabled": true }, { "key": "limit", "value": "", "disabled": true }, { "key": "updated_since", "value": "2026-09-17T12:00:00Z", "description": "ISO-8601 date or timestamp", "disabled": true } ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "description": "Delivery attempts for one subscription, newest first: kind, event id and type, status, attempt, status_code, latency_ms and error_class (dns_blocked, tls_error, timeout, refused, http_4xx, http_5xx, …). Response bodies and headers are never stored or shown. Example: GET /labs/api/v1/webhooks/whk_01J…/deliveries?limit=20" } }, { "name": "Rotate a webhook secret", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" } ], "url": { "raw": "{{baseUrl}}/webhooks/whk_example01/rotate-secret", "host": [ "{{baseUrl}}" ], "path": [ "webhooks", "whk_example01", "rotate-secret" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "description": "Replace the signing secret. The new whsec_ secret is returned once. The old secret keeps verifying for 24 h (or until the sandbox ends, whichever is first): during that overlap window, deliveries carry both signatures space-separated in webhook-signature. Example: POST /labs/api/v1/webhooks/whk_01J…/rotate-secret" } }, { "name": "Send a test webhook", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" } ], "url": { "raw": "{{baseUrl}}/webhooks/whk_example01/test", "host": [ "{{baseUrl}}" ], "path": [ "webhooks", "whk_example01", "test" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "description": "Queue a webhook.test ping (202). On an active subscription it is a test delivery; on a pending or failed one it is the verification ping that activates it on 2xx. Errors: 409 webhook_disabled. Example: POST /labs/api/v1/webhooks/whk_01J…/test" } } ] }, { "name": "Exports", "item": [ { "name": "Create a CSV export link", "request": { "method": "POST", "header": [ { "key": "Idempotency-Key", "value": "{{$guid}}", "type": "text" }, { "key": "Content-Type", "value": "application/json", "type": "text" } ], "url": { "raw": "{{baseUrl}}/exports", "host": [ "{{baseUrl}}" ], "path": [ "exports" ] }, "auth": { "type": "bearer", "bearer": [ { "key": "token", "value": "{{factoryKey}}", "type": "string" } ] }, "body": { "mode": "raw", "raw": "{\n \"dataset\": \"sales_orders\"\n}", "options": { "raw": { "language": "json" } } }, "description": "Mint a read-only, tokenised CSV export URL for one dataset, valid for 30 minutes. GET on that URL needs no auth header at all, so Excel Power Query and Google Sheets IMPORTDATA can pull it directly. Either key; Idempotency-Key honoured. At most 10 live tokens per sandbox. Datasets: sales_orders, customers, work_orders, print_runs, purchase_orders, supplier_invoices, customer_invoices, ledger, inventory, employees, timesheets, payroll_runs — the last three (employees, timesheets, payroll_runs) need modules.hr. Errors: 422 invalid_dataset, 404 module_disabled, 409 export_limit_reached. Example: {\"dataset\":\"sales_orders\"}" } }, { "name": "Download a CSV export", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/exports/xpt_example01?dataset=", "host": [ "{{baseUrl}}" ], "path": [ "exports", "xpt_example01" ], "query": [ { "key": "dataset", "value": "", "disabled": true } ] }, "description": "Download a dataset CSV by its export token — no Authorization header, so spreadsheet tools can fetch it directly (e.g. Power Query \"From Web\", Google Sheets =IMPORTDATA(...)). A wrong, expired, revoked or forged token returns the identical 404 as one that never existed. Example: GET /labs/api/v1/exports/xpt_01J….csv" } } ] }, { "name": "World", "item": [ { "name": "Get the world summary", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/world", "host": [ "{{baseUrl}}" ], "path": [ "world" ] }, "description": "Fictional world summary: factories open now, the sandbox queue, atlases shipped in the last 24 h, all-time bankruptcies, contracts completed and Major Orders won and lost, and the current Major Order. The open and shipped counts are the sums of the continents' figures. Aggregates only; no key. Example: GET /labs/api/v1/world" } }, { "name": "Get the continent standings", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/world/continents", "host": [ "{{baseUrl}}" ], "path": [ "world", "continents" ] }, "description": "Per continent team in the fictional world: factories open now, qualifying factories and atlases shipped in the last 24 h, on-time %, shipped per factory-hour, contract lot completion, score, rank and plaques. Continents need 5 qualifying factories to rank. Example: GET /labs/api/v1/world/continents" } }, { "name": "List the active world contracts", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/world/contracts", "host": [ "{{baseUrl}}" ], "path": [ "world", "contracts" ] }, "description": "Active fictional continental contracts with aggregate progress only. Example: GET /labs/api/v1/world/contracts" } }, { "name": "List recent world events", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/world/events", "host": [ "{{baseUrl}}" ], "path": [ "world", "events" ] }, "description": "Recent fictional world events, newest first, at most 60: contracts issued and completed, bankruptcies, Major Order news, and factories opening, closing and shipping. Example: GET /labs/api/v1/world/events" } }, { "name": "Get the Major Order", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/world/major-order", "host": [ "{{baseUrl}}" ], "path": [ "world", "major-order" ] }, "description": "The current (or most recent) fictional Major Order: objective, progress, per-continent contributions (which add up to progress), end time and perk. The order is won when progress reaches the target before it ends. Example: GET /labs/api/v1/world/major-order" } } ], "auth": { "type": "noauth" } } ] }