STstuut
aether

Approve a knowledge proposal

Applies the proposed change to the playbook and records the reviewer and review notes.

post/v2/aether/playbook/proposals/{proposal_id}/approve

Request

  • Base URL
    https://api.stuut.ai (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Path parameters

proposal_idstring required

Request body

review_notesstring nullable

Optional reviewer notes

reviewed_bystring required

User performing the review

Response

Successful Response

idstring uuid required

Proposal ID

created_atstring date-time required

When this proposal was created

action'archive' | 'create' | 'revise' required
article_idstring uuid nullable

Target article

contentstring nullable

Proposed article content

customer_idstring nullable

Proposed customer scope

descriptionstring nullable

Proposed article description

collection'cash_application' | 'collections' | 'company' | 'credit_risk' | 'deductions' | 'disputes' | 'payments' nullable

Proposed collection

extraction_idstring uuid nullable

Extraction job that produced this

knowledge_type'declarative' | 'document' | 'procedural'
review_notesstring nullable

Reviewer's notes

reviewed_atstring date-time nullable

When reviewed

reviewed_bystring nullable

User who reviewed

segment_idstring nullable

Proposed segment scope

staleboolean

True when target article was modified after proposal creation

status'pending' | 'approved' | 'rejected' required
titlestring required

Proposed article title

Changes

No recorded changes to this operation across all 1 revision of this API.