/pending-approvals/{pendingId}/rejectReject Change
Records a checker rejection decision on a pending change, capturing an optional reason in status_reason.
Errors:
K9O_APPROVAL_NOT_PENDING(409) for a decision on a change not inpending_approvalstatusK9O_APPROVAL_CANCELLED_BY_MAKER(409) for a decision on a maker-cancelled rowK9O_APPROVAL_NOT_AUTHORIZED(403) if the caller is not in the change's denormalizedapprover_setand holds no active approval delegationK9O_APPROVAL_EXPIRED(410) when acting on an expired change
On rejection the pending-change status transitions to rejected and a data.write.approval.* audit event is emitted; the change is not committed.
| pendingId * | path | The pending change's id ( |
| projectSlug * | path | The project's slug: the path segment after It is unique within the org. |
| reason | any | Why you decided this way. Surrounding whitespace is trimmed, and an empty string counts as no reason. Required to reject. |
| One of: string | ||
| or: null | ||
| reviewBasis | "read" | "verified" | "unread" | What you went on. Required to approve a held function call or MCP tool call, and ignored for other changes. |
| HTTP | K9O Code | Description |
|---|---|---|
| 200 | Success | |
| 401 | K9O_SESSION_EXPIRED | The caller's session token is expired or invalid; re-authenticate to continue. |
| 403 | K9O_IAM_POLICY_DENIED | The caller's bound IAMPolicy ceiling denies approvals:manage, so they are not authorised to reject pending changes in this project. |
| 403 | K9O_RBAC_DENY | A session is required to reject a pending change: a personal access token alone is refused with `context.reason` `session_required`, and a service, workload or extension token with `human_only`. |
| 404 | K9O_POLICY_NOT_FOUND | No pending-approval record with the supplied identifier exists or is accessible in this project. |
| 409 | K9O_STATE_CONFLICT | The pending change is not in a state that permits rejection; it has already been decided, expired, or cancelled, or it was decided concurrently. |
| data * | object | A pending change: a write or action held until an approver decides it. |
| id * | string | The pending change id ( |
| status * | "pending_approval" | "approved" | "redeemed" | "rejected" | "expired" | "cancelled" | "superseded" | Where the change stands. |
| collection * | any | The collection the change writes to. Null for a change that is not a data write, such as a function call or a platform action. |
| One of: string | ||
| or: null | ||
| operation * | any | The kind of write: Null for a change that is not a data write. |
| One of: string | ||
| or: null | ||
| makerId * | string | Who proposed the change: a user ( |
| proposedPayload * | object | What the change would do. For a data write it is the proposed record. For any other change it holds that change's own details: a policy publish, for example, carries |
| targetRecordId * | any | The id of the record (or policy bundle) the change targets. Null for an insert and for a change with no single target. |
| One of: string | ||
| or: null | ||
| approverId * | any | Who decided the change ( Null while it is undecided. |
| One of: string | ||
| or: null | ||
| decidedAt * | any | When the change was decided. Null while it is undecided. |
| One of: string <date-time> | ||
| or: null | ||
| decisionReason * | any | The reason the approver gave. Null when none was given. |
| One of: string | ||
| or: null | ||
| createdAt * | string <date-time> | When the change was proposed. |
| expiresAt * | any | When the change expires if it is still undecided. Null when it does not expire. |
| One of: string <date-time> | ||
| or: null | ||
| meta * | any | |
// const k9o = new K9o({ orgSlug: 'playground', projectSlug: 'storefront', apiKey: 'k9o_…' })
const { data } = await k9o.approvals.reject('apr_3Lq9Wx2Km7Rp5Tz8', {})Showing example in TypeScript
{
"reason": "string",
"reviewBasis": "read"
}{
"data": {
"id": "string",
"status": "pending_approval",
"collection": "string",
"operation": "string",
"makerId": "string",
"targetRecordId": "string",
"approverId": "string",
"decidedAt": "string",
"decisionReason": "string",
"createdAt": "string",
"expiresAt": "string"
}
}