Skip to main content

Ingest source data

POST

Submits metric payloads to your environment's ingestion source for processing.

Before you call this endpoint​

  • Use the sourceId assigned to your environment
  • Use the matching push token provided for that source

Authentication​

  • Send the customer push token as Authorization: Bearer <token>

Request body​

Example request body​

{
  "metrics": [
    {
      "fields": {
        "value": 94.01,
        "timestamp": 1740047760
      },
      "name": "central_O2_sensor",
      "tags": {
        "nodeName": "O2_16",
        "nodeType": "O2_sensor",
        "aggregation": "avg",
        "tank": "tank_16"
      }
    }
  ]
}

Response​

  • 202 Accepted: request stored and accepted for processing
  • 200 OK: duplicate request detected and skipped

Errors​

  • 400: source not found
  • 400: request body is not valid JSON
  • 401: missing or invalid bearer token
  • 403: invalid token or token does not have push role

Notes​

  • Flexible mapping is supported, but custom mapping is prepared together with Eyer support