Facet counts and masthead metrics

GET

/v1/sessions/facets

const url = 'https://app.everruns.com/api/v1/sessions/facets?agent_id=agent_01933b5a00007000800000000000001';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://app.everruns.com/api/v1/sessions/facets?agent_id=agent_01933b5a00007000800000000000001'

Parameters

Query Parameters

agent_id

string

Example

agent_01933b5a00007000800000000000001

search

string

source

string

status

string

mine

boolean

created_after

string

created_before

string

order

string

Responses

200

Facet counts over the applied filters

application/json

Facet-rail counts and masthead metrics for the sessions surface (EVE-852).

Every count is aggregated server-side over the same filter predicate as GET /v1/sessions, so a client never derives them by paging the list. Each facet dimension is counted with the other filters applied but its own selection excluded, which is what lets the rail offer multi-select.

object

active_now

required

Sessions executing a turn or awaiting client tool results right now.

integer format: int64

by_activity

required

Counts per derived activity (running, paused, failed, completed, idle).

Array<object>

One bucket of a sessions facet dimension.

object

count

required

integer format: int64

value

required

The dimension value: an activity, a source, or an agent’s public id.

string

by_agent

required

Counts per agent, keyed by the agent’s public id. Sessions with no agent are omitted.

Array<object>

One bucket of a sessions facet dimension.

object

count

required

integer format: int64

value

required

The dimension value: an activity, a source, or an agent’s public id.

string

by_source

required

Counts per session source.

Array<object>

One bucket of a sessions facet dimension.

object

count

required

integer format: int64

value

required

The dimension value: an activity, a source, or an agent’s public id.

string

failed_today

required

Sessions whose most recent turn failed or was cancelled today (UTC).

integer format: int64

p95_duration_ms

required

95th percentile session duration over the filtered set, milliseconds.

integer format: int64

tokens_today

required

Tokens consumed by sessions created today (UTC).

integer format: int64

total

required

Sessions matching every applied filter.

integer format: int64

Example

{
  "by_activity": [
    {
      "value": "running"
    }
  ],
  "by_agent": [
    {
      "value": "running"
    }
  ],
  "by_source": [
    {
      "value": "running"
    }
  ]
}

400

Unknown filter value

500

Internal server error