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://api.agentsworklog.dev/v1

GET /v1/sessions/summary

Session summary

Returns everything worth knowing since since: newly raised Notables, high-risk work currently active, and PRs that merged in the window. Omit since and it defaults to the caller's previous session.

The response groups results so a client can render them directly:

new_notables — alignment signals raised in the window.
high_risk_active — active work at high or critical risk.
merged_prs — PRs merged since the timestamp.

Query parameters

ParameterTypeDescription

repo required

string

Repository to summarize, as owner/name.

since optional

timestamp

Only report changes after this ISO 8601 time. Defaults to the caller's last session.

REQUEST

curl https://api.agentsworklog.dev/v1/sessions/summary \
  -H "Authorization: Bearer $TOKEN" \
  -G -d "repo=acme/web" \
     -d "since=2026-07-02T09:00:00Z"

RESPONSE 200 OK

{
  "repo": "acme/web",
  "since": "2026-07-02T09:00:00Z",
  "new_notables": [
    {
      "id": "not_2Bd8Xk1",
      "title": "Payments v2 migration in progress",
      "severity": "high"
    }
  ],
  "high_risk_active": [
    {
      "id": "act_7Hs2Kd9",
      "title": "Refactor auth middleware",
      "risk": "high",
      "draft_pr_url": "https://github.com/acme/web/pull/482"
    }
  ],
  "merged_prs": [
    { "number": 479, "branch": "chore/payments-sdk" },
    { "number": 476, "branch": "fix/webhook-retry" }
  ]
}