---
title: "Reject a knowledge proposal"
method: POST
path: "/v2/aether/playbook/proposals/{proposal_id}/reject"
tags: ["aether"]
---

# Reject a knowledge proposal

`POST /v2/aether/playbook/proposals/{proposal_id}/reject`

## Request

- Base URL: `https://api.stuut.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stuut.ai/v2/aether/playbook/proposals/{proposal_id}/reject`
- Auth: HTTP bearer

Marks the proposal as rejected and records the reviewer and review notes.

## Path parameters

- `proposal_id` string, required

## Request body

- ApproveRejectInput
  - `review_notes` string, nullable: Optional reviewer notes
  - `reviewed_by` string, required: User performing the review

## Response `200`

Successful Response

- KnowledgeProposal
  - `id` string, uuid, required: Proposal ID
  - `created_at` string, date-time, required: When this proposal was created
  - `action` 'archive' | 'create' | 'revise', required
  - `article_id` string, uuid, nullable: Target article
  - `content` string, nullable: Proposed article content
  - `customer_id` string, nullable: Proposed customer scope
  - `description` string, nullable: Proposed article description
  - `collection` 'cash_application' | 'collections' | 'company' | 'credit_risk' | 'deductions' | 'disputes' | 'payments', nullable: Proposed collection
  - `extraction_id` string, uuid, nullable: Extraction job that produced this
  - `knowledge_type` 'declarative' | 'document' | 'procedural'
  - `review_notes` string, nullable: Reviewer's notes
  - `reviewed_at` string, date-time, nullable: When reviewed
  - `reviewed_by` string, nullable: User who reviewed
  - `segment_id` string, nullable: Proposed segment scope
  - `source_excerpts` SourceExcerpt[], nullable: Verbatim excerpts from the source
    - `text` string, required: Verbatim snippet from the source
    - `memory_id` string, nullable: Memory ID this excerpt came from, when sourced from memory
    - `page` integer, nullable: Page number in the source document
  - `stale` boolean: True when target article was modified after proposal creation
  - `status` 'pending' | 'approved' | 'rejected', required
  - `title` string, required: Proposed article title

## Other responses

- `422`: Validation Error

---

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