Get quota usage for a specific metric
Returns current usage and limit for a single quota metric. The metric must be URL-encoded (e.g. compute%2Fmachines). With workspace context, allocation quotas are scoped to that workspace exactly as quotas.list reports them. Concurrency metrics are measured per cluster and need cluster_id.
Authorizations
workspace API token (sk_akua_...) or OAuth2 JWT. Create tokens at https://akua.dev/developers/api-tokens
Headers
Optional workspace/scope context for the request. Carries a single workspace wire id (ws_…) today. Only needed for broad tokens — a workspace-owned token implies its workspace.
1 - 53"ws_j572abc123def456"
Path Parameters
Quota metric (URL-encoded service/resource).
"compute/machines"
Query Parameters
Cluster ID to include cluster-scoped concurrency quotas
1 - 54Response
Quota info
Metric: service/resource. Not unique on its own — see the scope field. Index by (metric, scope).
"compute/machines"
Allocation = max owned, rate = max per time window, concurrency = max in-flight, lifetime = a one-time grant. Only rate has a resets_at: a lifetime entitlement has no period, is never released by deleting the resource it funded, and reports its position in that one-way lifecycle as grant_state.
allocation, rate, concurrency, lifetime "allocation"
Identity the limit/usage numbers are bound to, and the second half of an entry's key. workspace is occupancy inside the workspace; principal aggregates across every workspace and organization owned by the same authenticated identity, so a new workspace does not grant fresh free capacity; cluster bounds in-flight work for one cluster. A metric enforced against more than one identity — every free-tier allocation, for example — returns one entry per scope, so (metric, scope) is the composite key. Indexing a listing by metric alone silently drops entries.
workspace, principal, cluster "workspace"
"Compute machines"
Unit the limit/usage numbers are measured in.
count, cores, bytes, seconds, count/day, count/minute, cents/day "count"
1
0
1
For rate quotas only: Unix timestamp (seconds) at which the window resets. Absent on every other type, including lifetime, which has no period.
x >= 0For lifetime quotas only: state of the one-time grant.
available, consumed, revoked "available"