n8n-nodes-roblox 2.4.25 → 2.4.27

package/README.md

@@ -15,6 +15,8 @@ This project provides custom community nodes for [n8n](https://n8n.io) that inte
 - Team Create Open Cloud support for settings, active sessions, team test shutdowns, and membership removal
 - Storage Open Cloud support for data stores, memory store queues, memory store sorted maps, memory store flush operations, and ordered data stores
 - Luau Execution Open Cloud support for creating tasks, polling task state, reading logs, and creating binary inputs
+- Group Forum Open Cloud support for listing forum categories, posts, and comments
+- Bans and Blocks Open Cloud support for universe-level and place-level user restrictions
 
 > ✅ Ideal for developers using Roblox + automation tools like n8n to build dashboards, pipelines, and custom tools.
 
@@ -23,12 +25,12 @@ This project provides custom community nodes for [n8n](https://n8n.io) that inte
 - `Roblox Cloud`
   - `Config`: operations `get_config_values`, `get_config_full`, `get_config_draft`, `update_config_draft`, `reset_config_draft`, `overwrite_config_draft`, `publish_config_draft`, `list_config_revisions`, `restore_config_revision`. Arguments: `universeId`, `repository`, `entriesJson`, `previousDraftHash`, `draftHash`, `publishMessage`, `deploymentStrategy`, `revisionId`, `config_revision_filters` (`endTime`, `maxPageSize`, `searchKey`, `skip`, `sortKey`, `sortOrder`, `startTime`).
   - `Engine`: operation `get_operation`. Arguments: `operationPath`.
-  - `Group`: operations `accept_join_request`, `ban_user`, `decline_join_request`, `get_group`, `get_memberships`, `get_role`, `get_roles`, `get_shout`, `get_join_requests`, `unban_user`, `update_group_shout`, `update_member_role`. Arguments: `groupId`, `joinRequestId`, `userId`, `message`, `roleId`, `arguments_memberships` (`maxPageSize`, `pageToken`, `filter`).
+  - `Group`: operations `accept_join_request`, `assign_member_role`, `ban_user`, `decline_join_request`, `get_audit_log`, `get_group`, `get_group_policies`, `get_join_requests`, `get_manageable_groups`, `get_memberships`, `get_pending_groups`, `get_role`, `get_roles`, `get_settings`, `list_forum_categories`, `list_forum_comments`, `list_forum_posts`, `unassign_member_role`, `unban_user`, `update_description`, `update_member_role`, `update_notification_preference`, `update_settings`. Arguments: `groupId`, `joinRequestId`, `membershipId`, `forumCategoryId`, `postId`, `userId`, `roleId`, `description`, `groupPolicyGroupIds`, `arguments_memberships` (`maxPageSize`, `pageToken`, `filter`), `group_join_requests_query` (`maxPageSize`, `pageToken`, `filter`), `group_roles_query` (`maxPageSize`, `pageToken`), `group_forum_categories_query` (`maxPageSize`, `pageToken`, `filter`), `group_forum_posts_query` (`maxPageSize`, `pageToken`, `filter`, `view`), `group_forum_comments_query` (`maxPageSize`, `pageToken`, `filter`), `group_audit_log_query` (`actionType`, `userId`, `limit`, `cursor`, `sortOrder`), `group_settings_update`, and `group_notification_preference`.
   - `Luau Execution`: operations `create_session_task_binary_input`, `create_session_task`, `create_session_task_for_version`, `get_session_task`, `list_session_task_logs`. Arguments: `universeId`, `placeId`, `versionId`, `luauExecutionSessionId`, `taskId`, `binaryInputSize`, `script`, `timeout`, `binaryInput`, `enableBinaryOutput`, `luauExecutionTaskView`, `luau_execution_task_logs_query` (`maxPageSize`, `pageToken`, `view`).
   - `Place`: operations `get_place`, `update_place`. Arguments: `universeId`, `placeId`, `place_update_mask` (`displayName`, `description`, `serverSize`).
   - `Storage`: operations include data store control (`list_data_stores`, `delete_data_store`, `undelete_data_store`, `snapshot_data_stores`), data store entries and scoped entries (`list`, `get`, `create`, `update`, `delete`, `increment`, `list revisions`), memory store queues (`create`, `read`, `discard`), memory store sorted maps (`list`, `get`, `create`, `update`, `delete`), memory store flush (`flush_memory_store`, `get_memory_store_flush_operation`), and ordered data store entries (`list`, `get`, `create`, `update`, `delete`, `increment`). Arguments: `universeId`, `dataStoreId`, `scopeId`, `entryId`, `queueId`, `sortedMapId`, `itemId`, `orderedDataStoreId`, `operationId`, `dataStoreEntryJson`, `incrementDataStoreEntryJson`, `memoryStoreQueueItemJson`, `discardMemoryStoreQueueItemsJson`, `memoryStoreSortedMapItemJson`, `orderedDataStoreEntryJson`, `incrementOrderedDataStoreEntryJson`, query/update collections for list, create, read, and update operations (`filter`, `maxPageSize`, `pageToken`, `showDeleted`, `id`, `allowMissing`, `allOrNothing`, `count`, `invisibilityWindow`, `orderBy`).
   - `Team Create`: operations `close_team_test_session`, `get_active_session_members`, `get_many_team_create_settings`, `get_team_create_settings`, `remove_team_create_membership`, `update_team_create_settings`. Arguments: `placeId`, `gameId`, `team_create_pagination` (`cursor`, `limit`), `universeId`, `isEnabled`, `userId`, `universeIds`.
-  - `Universe`: operations `generate_speech_asset`, `get_universe`, `get_user_restriction_universe`, `get_user_restrictions_universe`, `list_user_restriction_logs`, `publish_universe_message`, `restart_universe_servers`, `update_user_restriction_universe`. Arguments: `universeId`, `topic`, `message`, `userId`, `arguments_list_user_restriction_logs` (`pageToken`, `maxPageSize`), `speechText`, `speechStyleFields` (`pitch`, `speed`, `voiceId`), `restriction_update_mask` (`active`, `displayReason`, `duration`, `excludeAltAccounts`, `privateReason`).
+  - `Universe`: operations `generate_speech_asset`, `get_place_user_restriction`, `get_universe`, `get_user_restriction_universe`, `get_user_restrictions_universe`, `list_place_user_restrictions`, `list_user_restriction_logs`, `publish_universe_message`, `restart_universe_servers`, `update_place_user_restriction`, `update_user_restriction_universe`. Arguments: `universeId`, `placeId`, `userRestrictionId`, `topic`, `message`, `user_restrictions_query` (`maxPageSize`, `pageToken`), `arguments_list_user_restriction_logs` (`filter`, `maxPageSize`, `pageToken`), `idempotencyKeyKey`, `idempotencyKeyFirstSent`, `userRestrictionUpdateMask`, `user_restriction_game_join_restriction` (`active`, `displayReason`, `duration`, `excludeAltAccounts`, `privateReason`, `startTime`), `speechText`, `speechStyleFields` (`pitch`, `speed`, `voiceId`).
   - `User`: operations `generate_thumbnail`, `get_subscription`, `get_user`. Arguments: `userId`, `universeId`, `subscriptionProductId`, `subscriptionId`, `view`, `arguments_thumbnail_generation` (`size`, `format`, `shape`).
 - `Roblox Legacy`
   - `Legacy Place`: operations `get_favorites_count`, `get_universe_products`. Arguments: `universeId`, `universeIds`.
@@ -36,6 +38,10 @@ This project provides custom community nodes for [n8n](https://n8n.io) that inte
 - `Roblox Cloud Trigger`
   - Events: `Group Audit Log Entry`, `Group Join Request`. Arguments: `eventType`, `groupId`, audit-log filters `actionType`, `userId`, `limit`, and join-request page size `maxPageSize`.
 
+## Group API Scopes
+
+The Group resource uses the existing Roblox Cloud API key credential. Group Forum category, post, and comment list operations require `group-forum:read`. Join request reads require `group:read`; accepting and declining join requests, updating group memberships, assigning roles, and unassigning roles require `group:write`. Listing or getting roles can use `group:read` to include non-guest role permissions. Audit log, description, settings, group policy, manageable groups, and pending groups operations require `legacy-group:manage`; notification preference updates require `legacy-user:manage`. Roblox's current Groups reference does not list an additional API-key scope for Get Group or List Group Memberships.
+
 ## Configs API Scopes
 
 The Config resource uses the existing Roblox Cloud API key credential. Published config, full config, draft, and revision reads require the `universe:read` scope. Draft changes, draft reset, publish, and revision restore require the `universe:write` scope.
@@ -44,6 +50,10 @@ The Config resource uses the existing Roblox Cloud API key credential. Published
 
 The Get Subscription user operation requires either `universe:write` or `universe.subscription-product.subscription:read`.
 
+## Bans and Blocks API Scopes
+
+The universe and place user restriction operations use the existing Roblox Cloud API key credential. Listing and getting user restrictions, and listing user restriction logs, require `universe.user-restriction:read`. Updating universe-level or place-level user restrictions requires `universe.user-restriction:write`. Roblox also documents group ban and blocked-keyword endpoints on the Bans and Blocks page, but those endpoints require legacy cookie authentication rather than the `RobloxCloudApi` API-key credential.
+
 ## Team Create API Scopes
 
 The Team Create resource uses the existing Roblox Cloud API key credential and requires the `legacy-team-collaboration:manage` scope.