Sessions

A session summary is the orientation an agent reads before its first edit: what changed since it was last here. It's a computed view over Activities, Notables, and merged PRs — the exact payload the Claude Code session-start hook consumes.

BASE URLhttps://<your-instance>/api/v1

GET /repos/{owner}/{repo}/session-summary

Session summary

Returns a prioritised orientation for the caller. The "since" boundary is the caller's own server-side session marker (keyed by agent) — there is no client-supplied timestamp. The response groups results so a client can render them directly:

critical_notables / high_notables / other_notables — Notables by importance (only high and critical are surfaced prominently by the session-start hook).
blocking_activity / active_activity — work in flight, blocking items first.
recently_merged — Activity Logs whose PRs merged recently.
reminders — active logs past the Draft-PR reminder window with no PR link; own_activity_ids marks the caller's own records; live_url is the feed link.

Query parameters

ParameterTypeDescription

agent optional

string

Which caller's "since last session" marker to use. Defaults to "web".

REQUEST

curl https://your-instance.example.com/api/v1/repos/acme/web/session-summary \
  -H "Authorization: Bearer $TOKEN" \
  -G -d "agent=claude-code"

RESPONSE 200 OK

{
  "repo": { "owner": "acme", "repo": "web" },
  "since": "2026-07-02T09:00:00Z",
  "critical_notables": [],
  "high_notables": [
    {
      "id": "ntb_2Bd8Xk1",
      "title": "Payments v2 migration in progress",
      "importance": "high"
    }
  ],
  "other_notables": [],
  "blocking_activity": [],
  "active_activity": [
    {
      "id": "act_7Hs2Kd9",
      "title": "Refactor auth middleware",
      "risk": "high",
      "pr_url": "https://github.com/acme/web/pull/482"
    }
  ],
  "recently_merged": [
    { "id": "act_3Ka91Lp", "branch": "chore/payments-sdk", "status": "merged" }
  ],
  "reminders": [],
  "own_activity_ids": [],
  "live_url": "https://your-instance.example.com/acme/web"
}