Skip to content
OffsightAI
Sign In

Resources · Offsight APIs

AI-ready factory data,
through a modern API.

Connect ERP systems, design tools, analytics dashboards and AI agents to live Offsight production data.

AI-ready request

curl -sS \
  -H "x-api-key: $OFFSIGHT_API_KEY" \
  "https://ai.offsight.com/api/apps/v1/open/production/products/4689/status"

200 OK

{
  "data": {
    "currentZone": { "zoneName": "Floors" },
    "counts": { "alert": 1, "success": 12, "save": 2 },
    "tasks": [
      { "task_name": "Deck fastening pattern", "resolved_status": "SUCCESS" },
      { "task_name": "Subfloor moisture check", "resolved_status": "ALERT" }
    ]
  }
}

Consistent base path

Every endpoint lives under /api/apps/v1/open on your Offsight host, with a full base URL ready to copy.

Simple authentication

Send a scoped API key in the x-api-key header and start building without a custom services project.

Scoped access

Requests are limited to the account and permissions behind the key, with usage visible in the API dashboard.

API console

Documentation, keys and usage live in Offsight.

Developers get the current reference from the same product your operations team uses.
  • Browse endpoints by workflow: planning, production, materials, labor and alerts.
  • See parameters, examples and response samples without leaving the product.
  • Copy the base URL, request examples and response payloads in one click.
  • Manage sandbox and production keys from the same screen.
  • Track usage, limits and activity as calls land.
  • Download a PDF reference generated from the same API catalog.
Invoice status tracked through to paid on an Offsight purchase order

Access

Secure keys for modern automation.

Prototype with sandbox access, then move the same integration into production when it is approved.

Sandbox key

Use it to test ERP syncs, design imports and AI workflows before go-live.

Limits and expiry are visible in the dashboard.

Production key

Issued when your integration is ready for live operations.

Keys are hashed, scoped, revocable and built for secure production use.

Read and write through the same API

Use JSON POSTs for schedule updates, production orders, material records and other workflow changes.

Update a planned window

curl -sS -X POST \
  -H "x-api-key: $OFFSIGHT_API_KEY" \
  -H "content-type: application/json" \
  -d '{"updates":[
        {"level":"zone","product":"Module B1","zone":"Floors",
         "targetStart":"2026-07-01T07:00:00Z",
         "targetEnd":"2026-07-01T15:00:00Z"}
      ]}' \
  "https://ai.offsight.com/api/apps/v1/open/planning/schedule"

Invalid keys return 401. Rate limits return 429 with clear details and a Retry-After header when applicable.

Endpoint catalog

AI-ready endpoints for factory workflows.

Structured data for systems and AI agents that need production context.

Planning

Read and update schedules across projects, products and zones.

MethodPathWhat it returns or doesParameters
GET/planning/schedulePlanned and target dates for each project, product and zone.projects, products
POST/planning/scheduleUpdate schedule windows in one batched call.level, product, project, zone, targetStart, targetEnd

Production

Create orders from ERP or design-driven planning tools and read live station status.

MethodPathWhat it returns or doesParameters
POST/production/product-ordersCreate a production order with optional zone-level dates.projectOrderName, productName, productType, targetStart, targetEnd, zones[]
GET/production/productsFind Offsight product IDs for downstream API calls.project, product, limit, offset
GET/production/products/{id}/statusLive zone, task status and quality signals for a unit.id (path)
GET/production/products/{id}/zone-timeActual time in each zone and total time for the unit.id (path)
GET/production/products/{id}/historyTask history by zone with timestamps, user and status.id (path)
POST/usersCreate users from the system that owns your directory.name, username, email, userGroup, department
POST/departmentsCreate departments for reporting and access control.departmentName

Materials

Sync suppliers, materials, BOMs, warehouses, inventory and activity with ERP.

MethodPathWhat it returns or doesParameters
POST/materials/suppliersCreate suppliers with addresses and currency.supplierName, primaryContactName, contactEmail, currency, addresses[]
POST/materials/materialsCreate material records linked to suppliers and categories.materialId, materialName, materialCategory, supplier, unitOfMeasure, partNumber
POST/materials/bomsCreate product-type or shared BOMs.bomName, productType
POST/materials/boms/{id}/itemsAdd BOM materials, quantities and consuming zones.id (path), material, bomQty, zone
POST/materials/inventoryCreate project inventory with cost and reorder settings.material, project, initialCost, minStockQty, minOrderQty, warehouse
POST/materials/warehousesCreate one or many warehouses.warehouseNames[]
GET/materials/logsIssue, transfer and consumption history, filtered by project and product.projects, products

Labor

Pull time data for payroll, costing, capacity planning and AI forecasting.

MethodPathWhat it returns or doesParameters
GET/labor/product-hoursDaily hours by product.from, to, timezone
GET/labor/zone-hoursDaily hours by zone for capacity models.from, to, timezone
GET/labor/user-hoursDaily hours by user for payroll.from, to, timezone
GET/labor/project-hoursDaily hours by project order.from, to, timezone

Alerts

Read quality, labor, material and purchase-order exceptions as structured events.

MethodPathWhat it returns or doesParameters
GET/alerts/productionQuality and production events with task, form and submitter.date, product, productType, project, zone, alertType, currentStatus, user
GET/alerts/assignAssigned work alerts with due date and assignee.date, dueBy, product, productType, project, user
GET/alerts/laborLabor alerts by user, group or department.date, alertType, user, userGroup, department
GET/alerts/materialInventory and transfer alerts by material, product and project.date, alertType, materialName, product, productType, project, zone, user
GET/alerts/purchase-orderPurchase-order alerts with PO number, triggering answer and resolution.date, status, poNumber, triggeringAnswer, triggeredBy

Want to connect these APIs to your ERP, design tools, analytics or AI workflows?

Usage

Live metering built in.

Teams can see API usage before it becomes a problem.

Live meters

Usage bars update as calls land in the API dashboard.

Clear limits

Sandbox and production access show clear limits and remaining usage.

Admin alerts

Offsight notifies admins when usage needs attention.

Result shape

Filtered data that is ready to use.

Pull only the records your system or AI workflow needs.
  • Product lists support predictable paging.
  • Labor reports use date ranges and time zones for clean scheduled syncs.
  • Planning and material calls filter by project and product before data returns.
  • Alert calls return rows and counts for reporting, agents and dashboards.
  • Server-side filters keep integrations fast and focused.
A finished panel inspected before it leaves the line

Developer guide

Offsight API quick start

A concise primer for the base path, API key header, first read, first write, limits and common ERP-to-Offsight sync patterns.

Built for hands-on implementation, not a brochure.

Download the quick start

Under the API

The API connects to the production backbone.

It works with the same data Offsight, mobile users and AI workflows already use.

Live operational data. Reads and writes use the same production records as the Offsight console and mobile apps.

Integrations plus APIs. Use native ERP and design connectors where they fit, then use the API for custom workflows.

AI-assisted setup. Offsight AI helps map fields, generate workflows and guide configuration.

Modern cloud foundation. Secure cloud services, relational production data, caching and account-level separation support reliable integrations.

For the security review

What IT needs to know.

API access follows Offsight’s existing security model.
  • Encrypted in transit over TLS and encrypted at rest.
  • API keys are hashed, revocable and auditable.
  • Usage is metered by account so unusual volume is visible.
  • Console sign-in supports two-factor authentication and role-based module permissions.
  • Customer data is separated by account with audited access controls.
  • API access is controlled as its own module.

Read the Data Processing Addendum

Choosing the columns on an Offsight production report

Under the hood

Connect Offsight to the systems your team already uses.

Use the API to automate the flow between ERP, design models, shop-floor execution, analytics and AI tools. Your team controls the integration while Offsight keeps the production record current.
A developer working across multiple screens of code

See the API against your own workflows.

Bring an ERP product order, a model or BOM export, or a report you still build by hand.