Usage operations
Usage metering.
Each operation below is reachable at POST /v1/op/{operation_id} or the resource path POST /v1/{resource}/{action}, with a Bearer token (a gpra_ API key or a session token). Back to the Operations Reference index.
usage.current
Usage stats for the current billing period (storage, tiles, credits, jobs).
| Scope | usage:read |
| Side-effect | read |
| HTTP | POST /v1/op/usage.current · POST /v1/usage/current |
| Python / TypeScript | client.usage.current(…) |
| CLI | geopera usage current … |
Request — UsageCurrentInput
| Field | Type | Required | Description |
|---|---|---|---|
organization_id | string | yes |
Response — a streaming or binary payload (NDJSON / file / tile). Call the HTTP endpoint directly; the JSON SDK return does not apply.
usage.history
Historical usage (tile requests + peak storage) for the past N months.
| Scope | usage:read |
| Side-effect | read |
| HTTP | POST /v1/op/usage.history · POST /v1/usage/history |
| Python / TypeScript | client.usage.history(…) |
| CLI | geopera usage history … |
Request — UsageHistoryInput
| Field | Type | Required | Description |
|---|---|---|---|
organization_id | string | yes | |
months | integer | — |
Response — a streaming or binary payload (NDJSON / file / tile). Call the HTTP endpoint directly; the JSON SDK return does not apply.
usage.recalculate_storage
Recalculate an org’s storage from actual stored assets (org admin).
| Scope | usage:write |
| Side-effect | compute |
| HTTP | POST /v1/op/usage.recalculate_storage · POST /v1/usage/recalculate_storage |
| Python / TypeScript | client.usage.recalculate_storage(…) |
| CLI | geopera usage recalculate-storage … |
Request — RecalculateInput
| Field | Type | Required | Description |
|---|---|---|---|
organization_id | string | yes |
Response — a streaming or binary payload (NDJSON / file / tile). Call the HTTP endpoint directly; the JSON SDK return does not apply.