Skip to main content

Telemetry upload

Upload generation telemetry as a single CSV file per request:

  • plant_id — form field; must match an existing plant identifier for that customer.

POST https://api.ravenwits.com/api/v0/telemetry/upload/

Requires Bearer API key.


Request

multipart/form-data:

FieldTypeRequiredDescription
plant_idstringYesPlant name (must exist under Plants).
filefileYesCSV only (.csv extension).

Example (curl)

curl --request POST \
--url 'https://api.ravenwits.com/api/v0/telemetry/upload/' \
--header 'Authorization: Bearer {your-api-key}' \
--form 'plant_id=MY_PLANT_NAME' \
--form 'file=@./onlineHist.csv;type=text/csv'

Responses

StatusBody
201{ "message": "…" }
400Missing plant_id / file, not .csv, unknown plant, etc.
401Invalid or missing API key.
503AWS_TELEMETRY_BUCKET_NAME not set.
502S3 upload failure (permissions, network).