---
title: "List Knowledge Proposals"
method: GET
path: "/knowledge/proposals"
tags: ["Knowledge Graph"]
---

# List Knowledge Proposals

`GET /knowledge/proposals`

## Request

- Base URL: `/v1` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v1/knowledge/proposals`
- Auth: one of:
  - `app-cookie` (defined in the document in a form this page cannot read)
  - HTTP bearer

## Query parameters

- `page` integer
- `pageSize` integer
- `status` string[]
- `entityId` string[]

## Response `200`

OK

- PaginatedResponseBodyKnowledgeProposal
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `data` KnowledgeProposal[], required
    - `attributes` KnowledgeProposalAttributes, required
      - `attribute` string, required
      - `category` 'system_function' | 'actor' | 'system' | 'container' | 'infrastructure' | 'component' | 'code' | 'process' | 'concern' | 'decision' | 'event' | 'signal', required
      - `createdAt` string, date-time, required
      - `decisions` KnowledgeProposalDecision[], required
        - `createdAt` string, date-time, required
        - `impliedByProposalId` string
        - `status` 'confirmed' | 'rejected', required
        - `user` KnowledgeProposalPerson, required
          - `id` string, required
          - `name` string, required
      - `evidence` KnowledgeProposalEvidence, required
        - `assertion` string, required
        - `displayName` string, required
        - `effectiveAt` string, date-time, required
        - `id` string, required
        - `integrationDisplayName` string, required
        - `provider` string, required
        - `resourceRef` string, required
        - `subjectEntityId` string
      - `implies` KnowledgeProposalImplication[]
        - `id` string, required
        - `rejectedAt` string, date-time
        - `rejectedBy` KnowledgeProposalPerson
          - `id` string, required
          - `name` string, required
        - `status` 'pending' | 'rejected', required
        - `values` string[], required
      - `kind` string, required
      - `origin` 'name_similarity' | 'identity_conflict', required
      - `rationale` string, required
      - `status` 'pending' | 'confirmed' | 'rejected', required
      - `values` KnowledgeProposalValue[], required
        - `entity` KnowledgeProposalValueEntity
          - `aliases` KnowledgeGraphEntityAlias[], required
            - `attributes` KnowledgeGraphSubjectAliasAttributes, required
              - …
            - `id` string, required
            - `integrationDisplayName` string
            - `lastRecordedAt` string, date-time
            - `mergedByProposal` KnowledgeGraphAliasMerge
              - …
            - `name` string
            - `provider` string
          - `displayName` string, required
          - `id` string, required
        - `value` string, required
    - `id` string, required
  - `pagination` Pagination, required
    - `page` integer, required
    - `pageSize` integer, required
    - `total` integer, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `422`: Unprocessable Entity
- `500`: Internal Server Error

## Changes

- **2026-10-16** (v1) `a5fa344e3b61`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rezible/apis/rezible-api/changes/knowledge/proposals/get.md)

---

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