---
title: "List Proposals"
method: GET
path: "/agent-knowledge/sessions/{session_id}/proposals"
tags: ["agent-knowledge"]
---

# List Proposals

`GET /agent-knowledge/sessions/{session_id}/proposals`

## Path parameters

- `session_id` string, required

## Query parameters

- `review_status` ProposalReviewStatus[] — Review statuses to include. Repeat the parameter to filter by multiple statuses.
- `page` integer
- `page_size` integer

## Response `200`

Successful Response

- ListAgentKnowledgeProposalsResponse
  - `proposals` AgentKnowledgeProposalResponse[], required
    - `id` string, required
    - `proposalKind` string, required
    - `organizationId` string, required
    - `sessionId` string, nullable
    - `chatId` string, nullable
    - `filePath` string, required
    - `summary` string, required
    - `reviewStatus` 'pending' | 'approved' | 'rejected' | 'conflicted', required
    - `reviewedByUserId` string, nullable, required
    - `reviewedAt` string, date-time, nullable, required
    - `createdAt` string, date-time, required
    - `details` union, required
      - AgentKnowledgeNoteProposalDetailsResponse
        - `proposalKind` 'note'
        - `targetEntryId` string, nullable
        - `quotedText` string, nullable
        - `quoteAnchor` string, nullable
        - `rationale` string, nullable
      - AgentKnowledgeFileProposalDetailsResponse
        - `proposalKind` 'file'
        - `changeType` 'create_memory' | 'update_file', required
        - `targetPath` string, required
        - `targetEntryKind` 'generated_summary' | 'generated_detail' | 'user_file' | 'memory' | 'skill', required
        - `targetEntryId` string, nullable
        - `summary` string, nullable
        - `baseContentEtag` string, nullable
        - `rationale` string, nullable
      - AgentKnowledgeSystemPromptProposalDetailsResponse
        - `proposalKind` 'system_prompt'
        - `changeType` 'create' | 'update' | 'delete', required
        - `scope` 'organization' | 'channel' | 'user', required
        - `targetPromptEntryId` string, nullable
        - `channelId` string, nullable
        - `userId` string, nullable
        - `title` string, nullable
        - `baseRevision` integer, nullable
        - `rationale` string, nullable
  - `total` integer, required
  - `page` integer, required
  - `pageSize` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/traversal/apis/fastapi.md) · [All operations](https://skmtc.net/traversal/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/traversal/fastapi/revisions/2134ebffd1ef/schema)