---
title: "List sessions for a repo"
method: GET
path: "/api/v1/cache/r/{repoId}/sessions"
tags: ["Sessions"]
---

# List sessions for a repo

`GET /api/v1/cache/r/{repoId}/sessions`

## Request

- Base URL: `https://entire.io` (the document declares no server; this is the origin it was published from)
- URL: `https://entire.io/api/v1/cache/r/{repoId}/sessions`
- Auth: none declared

Returns the authoritative session list for a repo from entire-api.

## Path parameters

- `repoId` string, required

## Query parameters

- `scope` 'all'
- `branch` string
- `search` string
- `authorFacet` string
- `authorFacetNot` string
- `agent` string
- `agentNot` string
- `model` string
- `modelNot` string
- `isReview` boolean
- `includeFacets` boolean
- `cursor` string
- `limit` integer

## Response `200`

Sessions list

- object
  - `sessions` object[], required
    - `sessionId` string, required
    - `displayName` string, required
    - `customName` string, nullable, required
    - `isPublic` boolean, required
    - `agent` string, nullable, required
    - `model` string, nullable, required
    - `kind` 'agent_review', nullable, required
    - `prompt` string, nullable, required
    - `firstCommitAuthorUsername` string, nullable, required
    - `firstCommitAuthorAvatarUrl` string, nullable
    - `startedAt` string, required
    - `lastActivityAt` string, required
    - `checkpointCount` number, required
    - `stepCount` number, required
    - `inputTokens` number, nullable, required
    - `outputTokens` number, nullable, required
    - `cacheCreationTokens` number, nullable, required
    - `cacheReadTokens` number, nullable, required
    - `attributionAgentLines` number, nullable, required
    - `attributionHumanAdded` number, nullable, required
    - `attributionHumanModified` number, nullable, required
    - `attributionHumanRemoved` number, nullable, required
    - `attributionTotalCommitted` number, nullable, required
    - `attributionCalculatedAt` string, nullable, required
  - `facets` object
    - `authors` object[], required
      - `value` string, required
      - `label` string, required
    - `agents` string[], required
    - `models` string[], required
  - `next_cursor` string, nullable, required
  - `repo_full_name` string, required
  - `app_has_access` boolean, nullable, required
  - `session_branch_exists` boolean, nullable, required
  - `history_status` 'pending' | 'syncing' | 'complete' | 'error', nullable, required
  - `history_complete` boolean, required
  - `source` 'db', required

## Other responses

- `400`: Invalid branch or cursor
- `403`: Checkpoint repo access denied — the source repo is public but its checkpoints live in a separate private repo the caller can't read.
- `404`: Repository not found

## Changes

- **2026-10-20** `aeb83a0fe3e5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/entire/apis/entire-api/changes/api/v1/cache/r/:repoId/sessions/get.md)

---

[API](https://skmtc.dev/entire/apis/entire-api.md) - [All operations](https://skmtc.dev/entire/apis/entire-api/llms.txt) - [OpenAPI document](https://skmtc.dev/entire/apis/entire-api/revisions/a24dfcc828d7?raw)