Approve a knowledge proposal
Requires an administrator of the URL account and its orchestration_studio feature. An authenticated member receives 404 when the feature is disabled. Account membership is checked before the feature and role; nonmembers receive 401. Proposal text and source metadata are untrusted content. Only status and page filter the list; source filtering and the full evidence-reference contract remain ENG-5875. Existing sources metadata (at most 20) is returned without excerpts. Accepts top-level JSON fields only (parameter wrapping is disabled). PATCH creates a new proposed revision and returns 201 with a new id; the original remains unchanged. Approve with edits creates and approves a new human revision. Only a current proposed revision may be changed; approved/rejected/superseded/revoked or old revisions return 409, including an identical retry. Expired proposals may be rejected but cannot be edited or approved. When signal learning is enabled at installation, account-feature and policy levels, held agent text requires release approval or an actual human text edit. Invalid text or no edits on PATCH returns 422; model validation may return message and attributes. Unknown fields are ignored; status is not editable. Approval may ingest embeddings after the decision. Only add proposals may be approved today; update, retire and expire kinds return 409.
Authorizations
This token can be obtained by visiting the profile page or via rails console. Provides access to endpoints based on the user permissions levels. This token can be saved by an external system when user is created via API, to perform activities on behalf of the user.
Path Parameters
Numeric account id; the authenticated caller must be a member.
Proposal id, scoped through the URL account.
Body
Null carries the existing value over; non-null input must be non-blank text.
Null carries the existing value over; non-null input must be non-blank text.
Null carries the existing value over; non-null input must be non-blank text.
Response
Success
Id.
Status.
proposed, approved, rejected, superseded, revoked Question.
Answer.
Confidence.
verified, tentative Author kind.
human, agent Approved at.
Closed at.
Created at.
Revision.
Rejection reason.
Kind.
add, update, retire, expire Valid from.
Valid until.
Audience verdict.
pass, hold, fail, null Audience verdict reason.
Released verdict.
pass, hold, fail, null Released verdict reason.
Observation count.
Quality reasons.
Urgency.
normal, time_sensitive Sources.
20Author.
Source conversation id.
Approved by.
Rejection suppressed count.
Previously rejected.
Embedding state.