Get Session Metrics | Devin API Documentation

curl -G https://api.devin.ai/v3/organizations/org_id/metrics/sessions \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d time_before=1704067200 \
     -d time_after=1703980800 \
     -d user_ids=user_12345 \
     -d user_ids=user_67890 \
     -d service_user_ids=service_abcde \
     -d playbook_id=playbook_98765

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

Get aggregated session metrics for the organization.

Authentication

AuthorizationBearer

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

Path parameters

org_idstringRequired

Query parameters

user_idslist of strings or nullOptional

service_user_idslist of strings or nullOptional

time_beforeintegerRequired

time_afterintegerRequired

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