Sign in
Project Access Tokens

Per-day request counts for every access token in a project

Changed on

Returns a zero-filled daily series of request counts for each of the project's access tokens, oldest first. Every day in the window is present, so a gap reads as zero rather than missing.

Revoked tokens are included, because the traffic they made before revocation is usually the reason you are looking.

days defaults to 30 and is capped at 60, which is also how long per-day counts are retained — a longer window cannot be answered.

A platform token sees every token in the project. A project access token sees only its own row, so it can watch its own traffic without being able to enumerate the project's other credentials by name.

get/projects/{id}/access-tokens/usage

Request

  • Base URL: https://api.volcano.dev
  • URL: https://api.volcano.dev/projects/{id}/access-tokens/usage
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer

Path parameters

idstring uuid required

Project ID

Query parameters

daysinteger

Number of trailing days to return (1-60, default 30).

Response

Successful response

token_idstring uuid required
namestring required
token_prefixstring required

The token's display prefix, which identifies the credential when its name does not. Revoking frees a name, so a project that rotated ci-deploy has two entries here both called ci-deploy. Not usable as a credential.

daysinteger required

Number of daily entries returned, always equal to the requested window.

total_requestsinteger required

Changes