Summarize an agent's sessions

GET/api/public/v1/agents/{agent_id}/sessions/summary

Returns four aggregates scoped to a single agent: total lifetime sessions, sessions active in the last 30 minutes, mean actions per session, and the single longest session's action count. Empty agents (no sessions) return all zeros, not 404.

curl --fail-with-body -X GET 'https://app.openlatch.ai/api/public/v1/agents/<agent_id>/sessions/summary' \
  -H "Authorization: Bearer $OPENLATCH_API_KEY"

import json
import os
import urllib.request

request = urllib.request.Request(
    'https://app.openlatch.ai/api/public/v1/agents/<agent_id>/sessions/summary',
    method='GET',
    headers={
        'Authorization': 'Bearer ' + os.environ['OPENLATCH_API_KEY'],
    },
)
with urllib.request.urlopen(request) as response:
    text = response.read().decode()
    print(json.dumps(json.loads(text), indent=2) if text else response.status)

#!/usr/bin/env bash
set -euo pipefail

curl -sS --fail-with-body -X GET 'https://app.openlatch.ai/api/public/v1/agents/<agent_id>/sessions/summary' \
  -H "Authorization: Bearer $OPENLATCH_API_KEY" | jq .

$headers = @{
  Authorization = "Bearer $env:OPENLATCH_API_KEY"
}
Invoke-RestMethod -Method GET -Uri 'https://app.openlatch.ai/api/public/v1/agents/<agent_id>/sessions/summary' -Headers $headers | ConvertTo-Json -Depth 20

Authorization

Role in the organization	This endpoint
`owner`	Allowed
`admin`	Allowed
`editor`	Allowed
`viewer`	Allowed

A key carries the role its owner holds in the organization. See Authentication.

API key scope: agents:read

Path parameters

Parameter	Type	Description
`agent_id`	string	Required.

Response

200 OK — the call succeeded.
401 Unauthorized — UNAUTHORIZED
402 Payment Required — license_expired
403 Forbidden — FEATURE_DISABLED, FORBIDDEN, INSUFFICIENT_SCOPE
404 Not Found — NOT_FOUND
422 Unprocessable Content — INVALID_ID, VALIDATION_ERROR
429 Too Many Requests — TOO_MANY_REQUESTS
500 Internal Server Error — INTERNAL_SERVER_ERROR, tenant_isolation_violation
503 Service Unavailable — FEATURE_STATE_UNAVAILABLE, SERVICE_UNAVAILABLE

Response fields

Field	Type	Description
`active_now`	integer	Sessions whose last_event_at is within the last 30 minutes.
`avg_actions_per_session`	number	Mean event_count across every session for the agent (rounded to 1 decimal).
`daily_action_counts`	array of integer	Summed event_count across every session for each of the last 7 UTC days, oldest first. Feeds the actions-per-session sparkline.
`daily_session_counts`	array of integer	Number of sessions whose first_event_at lands on each of the last 7 UTC days, oldest first.
`longest_session_actions`	integer	Highest event_count across every session for the agent.
`total_sessions`	integer

Example response

{
  "active_now": 0,
  "avg_actions_per_session": 0,
  "daily_action_counts": [
    3
  ],
  "daily_session_counts": [
    3
  ],
  "longest_session_actions": 0,
  "total_sessions": 0
}