---
title: "List repo editing sessions in the org this connection is bound to, defaulting to active sessions so agents can discov..."
method: GET
path: "/v1/repo-sessions"
tags: ["repos"]
---

# List repo editing sessions in the org this connection is bound to, defaulting to active sessions so agents can discov...

`GET /v1/repo-sessions`

## Request

- Base URL: `https://api.kody.codes`
- URL: `https://api.kody.codes/v1/repo-sessions`
- Auth: HTTP bearer

List repo editing sessions in the org this connection is bound to, defaulting to active sessions so agents can discover sessions to resume, inspect, publish, or discard without already knowing session ids.

Org permission: `package:read`.

## Query parameters

- `status` 'active' | 'published' | 'discarded' | 'all': Which repo session lifecycle status to include. Defaults to active sessions.
- `source_id` string: Optional repo-backed source id to narrow the session list.
- `limit` integer: Maximum sessions to return. Capped at 100.

## Response `200`

Success.

- object
  - `sessions` object[], required
    - `id` string, required
    - `source_id` string, required
    - `source_root` string, required
    - `base_commit` string, required
    - `session_branch` string, required
    - `source_branch` string, required
    - `conversation_id` string, nullable, required
    - `last_checkpoint_commit` string, nullable, required
    - `last_check_run_id` string, nullable, required
    - `last_check_tree_hash` string, nullable, required
    - `expires_at` string, nullable, required
    - `created_at` string, required
    - `updated_at` string, required
    - `published_commit` string, nullable, required
    - `manifest_path` string, required
    - `entity_type` 'package' | 'repo', required
    - `status` 'active' | 'published' | 'discarded', required
    - `resolved_target` union, required
      - object
        - `kind` 'source', required
        - `source_id` string, required
        - `entity_kind` 'package' | 'repo', required
        - `entity_id` string, required
      - object
        - `kind` 'package', required
        - `source_id` string, required
        - `package_id` string, required
        - `kody_id` string, required
        - `name` string, required
      - object
        - `kind` 'repo', required
        - `source_id` string, required
        - `repo_id` string, required
        - `name` string, required

## Other responses

- `400`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `401`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `403`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `404`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `409`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `413`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `429`: Too many requests (edge IP/token limit) or an entitlement / plan-cap limit. Wait at least `Retry-After` seconds before retrying.
- `500`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `503`: Error envelope `{ "error": { "code", "message", "details"? } }`.
- `default`: Error envelope `{ "error": { "code", "message", "details"? } }`.

---

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