Get Session Metrics | Devin API Documentation

curl -G https://api.devin.ai/v3/enterprise/metrics/sessions \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d time_before=1711929600 \
     -d time_after=1706784000 \
     -d user_ids=user_12345 \
     -d user_ids=user_67890 \
     -d service_user_ids=service_abcde \
     -d org_ids=org_001 \
     -d org_ids=org_002 \
     -d playbook_id=playbook_7890

{
  "avg_acus_per_session": 3.7,
  "sessions_created_by_origin": {
    "api": 15,
    "automation": 27,
    "desktop": 8,
    "jira": 5,
    "linear": 3,
    "slack": 12,
    "teams": 7,
    "webapp": 20
  },
  "sessions_created_by_size": {
    "l": 10,
    "m": 25,
    "s": 30,
    "xl": 5,
    "xs": 2
  },
  "sessions_created_count": 72,
  "sessions_created_with_playbook_count": 40,
  "sessions_created_with_search_count": 15,
  "sessions_with_merged_prs_by_size": {
    "l": 4,
    "m": 10,
    "s": 8,
    "xl": 2,
    "xs": 1
  },
  "sessions_with_merged_prs_count": 25
}

Get aggregated session metrics for the enterprise account.

Optionally filter by playbook_id to get metrics for sessions created with a specific playbook.

Authentication

AuthorizationBearer

Personal API Key (apk_user_) or Service API Key (apk_)

Query parameters

user_idslist of strings or nullOptional

service_user_idslist of strings or nullOptional

time_beforeintegerRequired

time_afterintegerRequired

org_idslist of strings or nullOptional

playbook_idstring or nullOptional

Response

Successful Response

avg_acus_per_sessiondouble

sessions_created_by_originobject

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_sizeobject

Session counts by size category.

sessions_created_countinteger

sessions_created_with_playbook_countinteger

sessions_created_with_search_countinteger

sessions_with_merged_prs_by_sizeobject

Session counts by size category.

sessions_with_merged_prs_countinteger

Errors

422

Unprocessable Entity Error