Get Usage By Template V1

Cost / token / job-count rollup grouped by agent_type. Joins UsageRecord against Job to pick up the template name…

GET /api/v1/usage/by-template

cURL

curl --request GET \
  --url 'https://api.computer.stateset.app/api/v1/usage/by-template' \
  --header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY"

200

{
  "rows": [
    {
      "template": "string",
      "jobs": 1,
      "tokens": 1,
      "cost_usd": 1.5
    }
  ],
  "total_jobs": 1,
  "total_tokens": 1,
  "total_cost_usd": 1.5
}

Cost / token / job-count rollup grouped by agent_type.

Joins UsageRecord against Job to pick up the template name. Sorted by cost descending so the biggest line items surface first.

Response

UsageByTemplateResponse

rows · UsageByTemplateRow[] · required

Sorted by cost descending. Empty when the tenant has no usage.

Show UsageByTemplateRow

template · string · required

agent_type value (built-in or tenant-owned).

jobs · integer · required

tokens · integer · required

cost_usd · number · required

total_jobs · integer · required

total_tokens · integer · required

total_cost_usd · number · required

Status codes

Code	Meaning
200	Successful Response

cURL

curl --request GET \
  --url 'https://api.computer.stateset.app/api/v1/usage/by-template' \
  --header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY"

200

{
  "rows": [
    {
      "template": "string",
      "jobs": 1,
      "tokens": 1,
      "cost_usd": 1.5
    }
  ],
  "total_jobs": 1,
  "total_tokens": 1,
  "total_cost_usd": 1.5
}