List Job Tags V1

Distinct tag values + counts across the tenant’s jobs. Pairs with the ?tag= filter on GET /jobs for tag discovery…

GET /api/v1/tags

cURL

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

200

{
  "rows": [
    {
      "tag": "priority",
      "count": 2
    }
  ],
  "total_unique_tags": 1
}

Distinct tag values + counts across the tenant’s jobs.

Pairs with the ?tag= filter on GET /jobs for tag discovery. Implementation pulls each tagged job’s params.tags and aggregates in Python — JSON-stored tags don’t have a portable GROUP BY across SQLite + Postgres, and tenant volume is bounded.

Response

TagListResponse

rows · TagSummary[] · required

Distinct tag values, sorted by count descending. Empty when the tenant has no tagged jobs.

Show TagSummary

tag · string · required

count · integer · required

Number of jobs carrying this tag.

total_unique_tags · integer · required

Status codes

Code	Meaning
200	Successful Response

cURL

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

200

{
  "rows": [
    {
      "tag": "priority",
      "count": 2
    }
  ],
  "total_unique_tags": 1
}