Skip to main content
GET
Get Session Metrics

Permissions

Requires a service user with the ViewAccountMetrics permission at the enterprise level.

Authorizations

Authorization
string
header
required

Service User credential (prefix: cog_)

Query Parameters

user_ids
string[] | null
service_user_ids
string[] | null
time_before
integer
required
time_after
integer
required
org_ids
string[] | null
playbook_id
string | null

Response

Successful Response

Response model for session metrics.

avg_acus_per_session
number
required
sessions_created_by_origin
SessionCountsByOrigin · object
required

Session counts by origin type, exposed on the v3 metrics API.

A curated subset of SessionOrigin: legacy origins (cli, vscode_extension, devin_spaces) are intentionally not surfaced. Counts for sessions with a scheduled DB origin roll into automation via the canonical db_origin_to_api mapping, since automations are a superset that schedules will migrate into.

sessions_created_by_size
SessionCountsBySize · object
required

Session counts by size category.

sessions_created_count
integer
required
sessions_created_with_playbook_count
integer
required
sessions_created_with_search_count
integer
required
sessions_with_merged_prs_by_size
SessionCountsBySize · object
required

Session counts by size category.

sessions_with_merged_prs_count
integer
required