Skip to content
Scope

List run filter facets

GET
/api/v1/requests/facets
 
curl --request GET \
  --url 'https://example.com/api/v1/requests/facets?projectId=00000000-0000-0000-0000-000000000000'

Returns every distinct value and its full-dataset count per categorical filter dimension for the Runs list rail. Counts are absolute over all non-deleted runs in the given project: they intentionally ignore the active search, date range, iteration, and categorical selections so every selectable value stays visible with a stable count. Requires ?projectId=. Computed with parallel $group aggregations (Cosmos has no $facet) and cached per-project for a short TTL.

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
projectId
required

Project scope. Required on scoped list and root-create operations; requests without a resolvable project are rejected with 400. There is no default project.

string
>= 1 characters
Example 
00000000-0000-0000-0000-000000000000

Project scope. Required on scoped list and root-create operations; requests without a resolvable project are rejected with 400. There is no default project.

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Success

Media type application/json
object
total
required
number
facets
required
object
workerType
required
Array<object>
object
value
required
string
count
required
number
status
required
Array<object>
object
value
required
string
count
required
number
outcome
required
Array<object>
object
value
required
string
count
required
number
model
required
Array<object>
object
value
required
string
count
required
number
os
required
Array<object>
object
value
required
string
count
required
number
priority
required
Array<object>
object
value
required
string
count
required
number
agentVersion
required
Array<object>
object
value
required
string
count
required
number
profileId
required
Array<object>
object
value
required
string
count
required
number
Example generated
{
  "total": 1,
  "facets": {
    "workerType": [
      {
        "value": "example",
        "count": 1
      }
    ],
    "status": [
      {
        "value": "example",
        "count": 1
      }
    ],
    "outcome": [
      {
        "value": "example",
        "count": 1
      }
    ],
    "model": [
      {
        "value": "example",
        "count": 1
      }
    ],
    "os": [
      {
        "value": "example",
        "count": 1
      }
    ],
    "priority": [
      {
        "value": "example",
        "count": 1
      }
    ],
    "agentVersion": [
      {
        "value": "example",
        "count": 1
      }
    ],
    "profileId": [
      {
        "value": "example",
        "count": 1
      }
    ]
  }
}