POST /api/v1/metering/report — estela-api-v1-0-documentation

v50

latestSwagger 2.0raw.githubusercontent.com2026-08-07695383.3 KB

api

Append one metered usage fact. Deduplicated by idempotency_key.

post/api/v1/metering/report

project_idstring uuid required

Project UUID (Project.pid) this usage rolls up to.

resource_kindstring required

resource_idstring required

interval_startstring date-time required

interval_endstring date-time required

metricsobject required

Open metric payload (network_bytes, storage_bytes, …).

idempotency_keystring required

kind'JOB_CLOSE' | 'DATA_DELETE' | 'ADJUSTMENT' | 'DELTA_SLICE'

source_refstring

reporterstring

Emitting service (e.g. bitmaker-proxy). Defaults to estela.

adjustment_reason'RECONCILE_SCRAPY_FINAL' | 'RECONCILE_STORAGE' | 'MANUAL'

idstring uuid required

recorded_atstring date-time required

duplicateboolean required

resource_kindstring required

resource_idstring required