client.approvals.reviewers

client.approvals.reviewers — the approvals.reviewers operations.

On AsyncKindgi every method is the same, awaited.

client.approvals.reviewers.list()

list(
    *,
    limit: int | None = None,
    cursor: str | None = None,
    role: Literal['standard', 'senior', 'admin'] | None = None,
    timeout: float | None = None,
) -> ReviewerCollectionPage

List reviewers registered for the caller's tenant. GET /v1/approvals/reviewers

Cursor-paginated. Optional ?role= narrows to a specific role class. Reviewer-role gate does NOT apply — roster management is an admin surface, not a reviewer-only action.

client.approvals.reviewers.register()

register(
    *,
    idempotency_key: str | None = None,
    timeout: float | None = None,
    **fields: Any,
) -> Reviewer

Register a reviewer. POST /v1/approvals/reviewers

Idempotent by (tenantId, userId). Re-registering rotates role/displayName rather than inserting a duplicate row.

client.approvals.reviewers.get()

get(*, timeout: float | None = None) -> Reviewer

Fetch a reviewer. GET /v1/approvals/reviewers/{reviewerId}

client.approvals.reviewers.unregister()

unregister(
    *,
    idempotency_key: str | None = None,
    timeout: float | None = None,
) -> UnregisterReviewerResult

Unregister (soft-delete) a reviewer. POST /v1/approvals/reviewers/{reviewerId}/unregister

Soft-delete so the audit trail survives — reviewer stops receiving new approvals but historical decisions still resolve.