Ingest structured data

The edge pipeline sends structured rows through the buffer and ingest service. Other systems can use the same branch-authenticated backend endpoint.

One table, a batch of rows

POST to /api/v1/branches/ingest with the branch's X-API-Key header. The key selects the branch schema. The table must exist; row fields must match its columns.

HTTP · replace host and key

POST https://YOUR_BACKEND/api/v1/branches/ingest
Content-Type: application/json
X-API-Key: YOUR_BRANCH_API_KEY

{
  "table": "detections",
  "rows": [
    {
      "camera_id": "entrance",
      "class": "person",
      "confidence": 0.91,
      "ts": "2026-01-01T08:00:00Z"
    }
  ]
}

Connect POS or other business sources

An external adapter can receive provider webhooks or poll an API, validate records, and map them to your branch tables. Invoice event names, authentication, retries, and deduplication depend on the POS provider.