List Guest Users — Confluence Cloud Macro

This Confluence macro retrieves all permissions for a given space, ensuring it collects the complete dataset even for large spaces.

It first resolves the target space key (either the current space or a provided parameter), then fetches the corresponding space ID required for API requests.

Using a loop with pagination support, the macro aggregates all permission entries across multiple API pages into a single collection.

From these permissions, it extracts unique user account IDs where the principal type is a user, avoiding duplicates through manual checks.

Next, the macro iterates over each collected user ID and performs additional API calls to fetch detailed user information.

It filters these users to identify only guest accounts (isGuest == true), again ensuring no duplicates are included in the final list.

Finally, the macro renders the output: if no guest users are found, it displays an informational message. Otherwise, it presents a styled list of guest users.