curl --silent --show-error --fail-with-body --request GET \
--url 'https://api.computer.stateset.app/api/v1/tags' \
--header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY"
{
"rows": [
{
"tag": "priority",
"count": 2
}
],
"total_unique_tags": 1
}
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 --silent --show-error --fail-with-body --request GET \
--url 'https://api.computer.stateset.app/api/v1/tags' \
--header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY"
{
"rows": [
{
"tag": "priority",
"count": 2
}
],
"total_unique_tags": 1
}
Confirm your deployment before running this request. This page describes an API contract;
a published reference does not establish hosted availability. Check the dated
host report and obtain your deployment URL and credentials.
Replace the example host if your provisioned service uses a different URL.
?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
TagSummary[]
required
integer
required
Status codes
| Code | Meaning |
|---|---|
200 | Successful Response |
Using this contract
Read the source OpenAPI document for declared schemas and alternatives. This page also includes documented corrections from the spec overlays. Example IDs and values are illustrative; replace them with records from your workspace.curl --silent --show-error --fail-with-body --request GET \
--url 'https://api.computer.stateset.app/api/v1/tags' \
--header "X-API-Key: $STATESET_COMPUTER_USE_API_KEY"
{
"rows": [
{
"tag": "priority",
"count": 2
}
],
"total_unique_tags": 1
}
Last modified on September 21, 2026