/pending-approvalsList Pending Approvals
Returns the caller's approver inbox: a cursor-paginated list of pending-change envelopes (pch_<base62>) where the caller is a member of the denormalized approver_set or holds an active approval delegation.
Supports filtering by status, collection, and maker.
The auth floor is approver_set membership or an active delegation row expanding the caller into an approver set.
| projectSlug * | path | The project's slug: the path segment after It is unique within the org. |
| HTTP | K9O Code | Description |
|---|---|---|
| 200 | Success | |
| 400 | K9O_INVALID_FIELD_VALUE | limit is not an integer between 1 and 200, or status is not one of pending_approval, approved, rejected, expired, redeemed. |
| 400 | K9O_INVALID_CURSOR | The cursor is malformed, or was issued for a different project, status filter or queue scope; omit it to start from the newest pending change. |
| 401 | K9O_SESSION_EXPIRED | The caller's session token is expired or invalid; re-authenticate to continue. |
| 403 | K9O_ACCESS_DENIED | The caller does not hold the minimum required role to view the pending-approvals inbox for this project. |
| data * | object[] | Pending changes, newest first. A project admin or auditor sees the whole queue; anyone else sees only the changes they proposed. When more match, |
| 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.list()Showing example in TypeScript
{
"data": [
{
"id": "string",
"status": "pending_approval",
"collection": "string",
"operation": "string",
"makerId": "string",
"targetRecordId": "string",
"approverId": "string",
"decidedAt": "string",
"decisionReason": "string",
"createdAt": "string",
"expiresAt": "string"
}
]
}