REST API Reference

API Reference

The full API reference is provided via Swagger/OpenAPI in the app at /api-docs.

Authentication

Use your Eryxon API key in the Authorization header as a Bearer token for integration endpoints. Admin browser endpoints such as api-export use the signed-in Supabase user session token.

---

Core Endpoints

Jobs API

• GET /api-jobs: List jobs (supports status, customer, job_number filters).
• POST /api-jobs: Create a new job (includes parts and operations).
• PATCH /api-jobs?id={id}: Update job details.

Parts & Operations

• GET /api-parts: List parts.
• GET /api-operations: List operations (supports part_id and cell_id filters).
• POST /api-operation-lifecycle: Start, pause, resume, or complete an operation.

Batches

• GET /api-batches: List operation batches by status, type, cell, or material.
• POST /api-batches: Create a batch and optionally assign tenant-validated operations.
• PATCH /api-batches?id={id}: Update batch details.
• POST /api-batch-lifecycle/start?id={id}: Start a ready or draft batch.
• POST /api-batch-lifecycle/stop?id={id}: Complete an in-progress batch and distribute tracked time.
• POST /api-batch-lifecycle/add-operations?id={id}: Append operations to a draft or ready batch.

Production Reporting

• POST /api-operation-quantities: Report good and scrap quantities with reasons.
• POST /api-issues: Create quality issues or Non-Conformance Reports (NCR).

Supporting Data

• GET /api-materials: Read-only unique material names from parts.material.
• /api-templates: Operation substep templates.
• GET /api-export: Admin-only JSON tenant export used by the in-app export flow.

---

ERP Sync (Bidirectional)

Sync records between Eryxon and external systems (SAP, NetSuite, etc.) using external_id mapping.

Sync Modes

• Diff (POST /api-erp-sync/diff): Preview changes before applying.
• Sync (POST /api-erp-sync/sync): Execute the update with change detection via sync_hash.
• Bulk Sync: Upsert up to 1,000 records in a single request.

---

Testing with cURL

List Jobs

curl -X GET "https://[URL]/functions/v1/api-jobs?limit=5" \
  -H "Authorization: Bearer ery_live_YOUR_KEY"

Create Job

curl -X POST "https://[URL]/functions/v1/api-jobs" \
  -H "Authorization: Bearer ery_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "job_number": "EX-100",
    "customer_name": "Acme",
    "parts": [{ "part_number": "P1", "quantity": 10 }]
  }'

---

Error Response Format

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid cell ID",
    "details": [...]
  }
}