Usage

Per-endpoint compute-unit usage

get

Compute-unit series for a single endpoint, which must belong to the calling team. An endpoint owned by another team returns 404, indistinguishable from one that never existed; the team's own deleted endpoints remain readable. Defaults to the current calendar month (UTC) when from/to are omitted.

Authorizations

AdminApiKey

AuthorizationstringRequired

Admin API key under the ApiKey scheme: Authorization: ApiKey vc_adm_.... Each key is bound to one team and carries a READ or WRITE scope; the usage endpoints require only READ.

Path parameters

idstring · uuidRequired

Endpoint UUID

Query parameters

fromstring · date-timeOptional

Inclusive window start, RFC3339

tostring · date-timeOptional

Exclusive window end, RFC3339

granularitystring · enumOptional

Bucket size. Max window per granularity: HOUR 7d, DAY 92d, WEEK/MONTH 366d; at most 750 buckets per request.

Default: DAYPossible values:

Responses

200

OK

application/json

compute_unitsinteger · int64OptionalExample: 22

fromstring · date-timeOptional

tostring · date-timeOptional

400

Bad Request

application/json

401

Unauthorized

application/json

404

Not Found

application/json

500

Internal Server Error

application/json

get/endpoints/{id}/usage

HTTPcURLJavaScriptPython

GET /admin/v1/endpoints/{id}/usage HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

{
  "compute_units": 22,
  "from": "2026-07-10T20:19:51.550Z",
  "series": [
    {
      "compute_units": 15,
      "time": "2026-07-10T20:19:51.550Z"
    }
  ],
  "to": "2026-07-10T20:19:51.550Z"
}

Team-wide compute-unit usage

get

Aggregated compute-unit usage for the team the admin key is bound to. Defaults to the current calendar month (UTC) when from/to are omitted.

Authorizations

AdminApiKey

AuthorizationstringRequired

Admin API key under the ApiKey scheme: Authorization: ApiKey vc_adm_.... Each key is bound to one team and carries a READ or WRITE scope; the usage endpoints require only READ.

Query parameters

fromstring · date-timeOptional

Inclusive window start, RFC3339

tostring · date-timeOptional

Exclusive window end, RFC3339

granularitystring · enumOptional

Bucket size. Max window per granularity: HOUR 7d, DAY 92d, WEEK/MONTH 366d; at most 750 buckets per request.

Default: DAYPossible values:

Responses

200

OK

application/json

compute_unitsinteger · int64OptionalExample: 22

fromstring · date-timeOptional

tostring · date-timeOptional

400

Bad Request

application/json

401

Unauthorized

application/json

500

Internal Server Error

application/json

get/usage

HTTPcURLJavaScriptPython

GET /admin/v1/usage HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

{
  "compute_units": 22,
  "from": "2026-07-10T20:19:51.550Z",
  "series": [
    {
      "compute_units": 15,
      "time": "2026-07-10T20:19:51.550Z"
    }
  ],
  "to": "2026-07-10T20:19:51.550Z"
}