---
title: "Get the compact changed-file manifest for the initial workspace review paint"
method: GET
path: "/api/v1/sessions/{sessionId}/workspace/manifest"
tags: ["sessions"]
---

# Get the compact changed-file manifest for the initial workspace review paint

`GET /api/v1/sessions/{sessionId}/workspace/manifest`

## Request

- Base URL: `http://127.0.0.1:3001`
- URL: `http://127.0.0.1:3001/api/v1/sessions/{sessionId}/workspace/manifest`
- Auth: none declared

## Path parameters

- `sessionId` string, required: Session identifier, e.g. project-1.

## Response `200`

OK

- WorkspaceManifestResponse
  - `compareBaseRef` string
  - `compareBaseSha` string
  - `compareMode` 'base' | 'head_fallback'
  - `degraded` boolean, required
  - `degradedCode` string
  - `files` WorkspaceFileSummary[], required
    - `additions` integer, required
    - `binary` boolean, required
    - `deletions` integer, required
    - `editable` boolean, required
    - `fileFingerprint` string, required
    - `path` string, required
    - `previousPath` string
    - `size` integer, required
    - `status` 'unmodified' | 'modified' | 'added' | 'deleted' | 'renamed', required
  - `refreshing` boolean, required
  - `sections` WorkspaceFileSections, required
    - `committed` WorkspaceFileSummary[], required
      - `additions` integer, required
      - `binary` boolean, required
      - `deletions` integer, required
      - `editable` boolean, required
      - `fileFingerprint` string, required
      - `path` string, required
      - `previousPath` string
      - `size` integer, required
      - `status` 'unmodified' | 'modified' | 'added' | 'deleted' | 'renamed', required
    - `staged` WorkspaceFileSummary[], required
      - `additions` integer, required
      - `binary` boolean, required
      - `deletions` integer, required
      - `editable` boolean, required
      - `fileFingerprint` string, required
      - `path` string, required
      - `previousPath` string
      - `size` integer, required
      - `status` 'unmodified' | 'modified' | 'added' | 'deleted' | 'renamed', required
    - `uncommitted` WorkspaceFileSummary[], required: Worktree vs HEAD, untracked files included. Always present; a response without it comes from an older daemon.
      - `additions` integer, required
      - `binary` boolean, required
      - `deletions` integer, required
      - `editable` boolean, required
      - `fileFingerprint` string, required
      - `path` string, required
      - `previousPath` string
      - `size` integer, required
      - `status` 'unmodified' | 'modified' | 'added' | 'deleted' | 'renamed', required
    - `unstaged` WorkspaceFileSummary[], required
      - `additions` integer, required
      - `binary` boolean, required
      - `deletions` integer, required
      - `editable` boolean, required
      - `fileFingerprint` string, required
      - `path` string, required
      - `previousPath` string
      - `size` integer, required
      - `status` 'unmodified' | 'modified' | 'added' | 'deleted' | 'renamed', required
    - `untracked` WorkspaceFileSummary[], required
      - `additions` integer, required
      - `binary` boolean, required
      - `deletions` integer, required
      - `editable` boolean, required
      - `fileFingerprint` string, required
      - `path` string, required
      - `previousPath` string
      - `size` integer, required
      - `status` 'unmodified' | 'modified' | 'added' | 'deleted' | 'renamed', required
  - `sessionId` string, required
  - `stale` boolean, required
  - `summary` WorkspaceSummary, required
    - `additions` integer, required
    - `deletions` integer, required
    - `files` integer, required
  - `truncated` boolean, required
  - `workspaceVersion` string, required

## Other responses

- `404`: Not Found
- `500`: Internal Server Error
- `501`: Not Implemented

## Changes

- **2026-10-21** `8f160e6183cd`: 3 info
  - removed the `agent_switch_saga` enum value from the `reporting_owner` response property for the response status `404`
  - removed the `agent_switch_saga` enum value from the `reporting_owner` response property for the response status `500`
  - removed the `agent_switch_saga` enum value from the `reporting_owner` response property for the response status `501`
- **2026-10-21** `9fd7084a4f87`: 1 info
  - added the required property `sections/uncommitted` to the response with the `200` status
- **2026-10-03** `b7fb6d9c5aa6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/changes/api/v1/sessions/:sessionId/workspace/manifest/get.md)

---

[API](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon.md) - [All operations](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/llms.txt) - [OpenAPI document](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/revisions/61d7efd08578?raw)