Approvals
listApprovalRequests
List approval requests
Lists approval requests for the project, newest first, optionally filtered by status.
Usage
const result = await api.approvals.listApprovalRequests({
pathParams: { project_id: "prj_xxx" },
});Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| pathParams.project_id | string | Yes | Unique project identifier (prefixed, e.g. prj_xxx). |
| queryParams.status | "pending" | "approved" | "rejected" | "expired" | "executed" | "failed" | No | Filter to a single status. |
| queryParams.page_size | number | No | Maximum number of items to return (1-100, default 20). |
| queryParams.page_token | string | No | Opaque token for cursor-based pagination. |
Response
Promise<ListApprovalRequestsResponse> — page of approval requests.
Example
import { PgBeamClient } from "pgbeam";
const client = new PgBeamClient({
token: "pbk_...",
baseUrl: "https://api.pgbeam.com",
});
const result = await client.api.approvals.listApprovalRequests({
pathParams: { project_id: "prj_xxx" },
queryParams: { status: "open", page_size: 20, page_token: "..." },
});Errors
| Status | Description |
|---|---|
| 400 | Invalid request parameters. |
| 401 | Missing or invalid authentication. |
| 403 | Operation not allowed by current plan limits. |
| 404 | Resource not found. |
| 429 | Rate limited. Try again later. |