v1

latestOpenAPI 3.0.32026-07-13218142597.2 KB
Space Permission Transition

List unassigned space permission combinations

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.

get/space-permissions/transition/combinations

Query parameters

cursorstring

Opaque cursor returned from a previous page in the cursor field of the response. Omit for the first page.

limitinteger

The maximum number of combinations to return per page. Requests outside the supported range return 400.

Response

Returned with the page of unassigned combinations (possibly an empty results array if no combinations exist or if combinations have not yet been generated for this tenant).

generatedAtstring nullable

ISO-8601 timestamp of the last audit run that populated the combinations table. Absent if the audit task has never run on this tenant.

cursorstring nullable

Opaque cursor for the next page. Absent when no further results exist.