/migrations/pendingList Pending Migrations
Returns the list of pending-migration records for the project, filterable by status (queued, applied, rejected, or cancelled) via the ?status= query parameter.
Terminal rows (applied, rejected, cancelled) are retained indefinitely for audit-trail integrity.
Requires any project member role (PROJECT_VIEWER or above).
Authorized by the IAM action migrations:read (every project role holds it by default; a workload needs it on its bound IAM policy; a project service token reads as its scope's role).
| projectSlug * | path | The project's slug: the path segment after It is unique within the org. |
| HTTP | K9O Code | Description |
|---|---|---|
| 200 | Success | |
| 401 | K9O_SESSION_EXPIRED | Your session has expired; re-authenticate and retry. |
| 403 | K9O_ACCESS_DENIED | You must hold at least a viewer role on the project to list pending migrations. |
| 403 | K9O_IAM_POLICY_DENIED | The bound IAM policy ceiling denies migrations:read (for a workload: its bound policy does not grant it). |
| data * | object[] | Pending migrations in the requested status (default |
| id * | string | The pending migration's id ( |
| version * | integer | The migration's version, an integer from 1 to 2147483647. Versions apply in ascending order. |
| slug * | string | The migration's slug, as given when it was submitted. |
| checksum * | string | SHA-256 (hex) of the migration's canonical JSON ( Re-applying a version with a different checksum is refused. |
| status * | "queued" | "pending_approval" | "applied" | "rejected" | "cancelled" |
|
| affectedCollections * | string[] | The collections the migration's operations and policy section touch. |
| approvalId * | any | The linked approval ( |
| One of: string | ||
| or: null | ||
| queuedAt * | string <date-time> | When the migration was queued. |
| queuedBy * | string | The id of the principal who queued it. |
| decidedAt * | any | When it was applied, rejected or cancelled; null while undecided. |
| One of: string <date-time> | ||
| or: null | ||
| decidedBy * | any | The id of the principal who decided it; null while undecided. |
| One of: string | ||
| or: null | ||
| decisionReason * | any | The reason recorded when it was rejected (empty when none was given) or cancelled (always empty); null while undecided or when it was applied. |
| One of: string | ||
| or: null | ||
| meta * | any | Request metadata: cost, timing and correlation ids. |
// const k9o = new K9o({ orgSlug: 'playground', projectSlug: 'storefront', apiKey: 'k9o_…' })
const { data } = await k9o.migrations.listPending()Showing example in TypeScript
{
"data": [
{
"id": "string",
"version": 0,
"slug": "string",
"checksum": "string",
"status": "queued",
"affectedCollections": [
"string"
],
"approvalId": "string",
"queuedAt": "string",
"queuedBy": "string",
"decidedAt": "string",
"decidedBy": "string",
"decisionReason": "string"
}
]
}