Function: listSpacePermissionCombinations()

function listSpacePermissionCombinations(client, parameters?): Promise<{
[key: string]: unknown;
  cursor?: string | null;
  generatedAt?: string | null;
  results: object[];
}>;

Defined in: src/v2/api/spacePermissionTransition.ts:26

Lists the unique unassigned space permission combinations currently present on the tenant. Combinations that already map to a space role are filtered out server-side. Each row carries the decoded set of space permissions and the principal types that currently hold the combination — these inform which principalType values are valid to include in the matching bulk role-assignments request.

Results are always sorted by principalCount descending. Sort field and sort order are not configurable; page size is controlled by the limit query parameter (default 25, min 1, max 250). Use the cursor field to page through additional results. The generatedAt field reflects the last audit run that populated the combinations table — call the generate-combinations endpoint to refresh stale data.

Permissions required: User must be a Confluence administrator.

Parameters

Parameter	Type	Description
client	Client	-
parameters?	{ cursor?: string; limit?: number; }	-
parameters.cursor?	string	Opaque cursor returned from a previous page in the cursor field of the response. Omit for the first page.
parameters.limit?	number	The maximum number of combinations to return per page. Requests outside the supported range return 400.

Returns

Promise<{ [key: string]: unknown; cursor?: string | null; generatedAt?: string | null; results: object[]; }>