Roam
for LuumenAI
Read Roam chats and groups, post updates and change membership with approval
Connect Roam and Luumen can read the channels, DMs, and groups your bot can see, pull chat history for an incident window, and look up who a user or group actually is. Posting a message, creating a group, or changing membership runs as a previewed step you approve first. Authentication is by API key.
The Roam toolbox
39 tools: 22 read, 17 write. Reads answer instantly. Writes require approval by default. Everything is logged.
- ReadGet Address InfoGet information about a chat address, which is the name for any entity that may participate in a chat, such as a user, visitor, or bot.
- ReadGet chat historyLists messages in a chat, filtered by date range (after/before).
- ReadGet meeting linkGet a meeting link.
- ReadGet Roam SCIM Resource TypesReturns the list of SCIM 2.0 resource types supported by Roam.
- ReadGet SCIM service provider configRetrieve Roam's SCIM service provider configuration.
- ReadGet SCIM schemaRetrieves the definition of a specific SCIM 2.0 schema by its unique identifier (URN).
- ReadGet user by ID (SCIM)Retrieve a single user by their Roam Person ID using SCIM 2.0 protocol.
- ReadTest API ConnectivityTest endpoint for API connectivity.
- ReadGet token infoRetrieves information about the current Roam access token.
- ReadGet user infoGet detailed information about a single user in your Roam workspace.
- ReadList Roam ChatsLists all accessible chats, which consist of all DMs, MultiDMs, and Channels that your bot has been added to, in addition to all public channels.
- ReadList group membersList members in a group in your Roam workspace.
- ReadList SCIM GroupsReturns a paginated list of groups in your Roam organization via SCIM 2.0.
- ReadList Roam LobbiesLists active lobbies in your Roam account.
- ReadList Roam MeetingsLists all meetings in your home Roam, filtered by date range.
- ReadList Roam RecordingsList all recordings in your home Roam.
- ReadList users (SCIM)List users in your Roam organization using SCIM 2.0 protocol.
- ReadList SCIM SchemasList all SCIM 2.0 schemas supported by Roam.
- ReadList Roam TranscriptsLists all transcripts in your Roam workspace, filtered by date range.
- ReadList User Audit LogGet a list of user audit log entries for the account.
- ReadList UsersList all users in the Roam workspace.
- ReadLookup user by emailLook up a user in your Roam workspace by their email address.
- WriteAdd group membersAdd one or more group members and/or admins to an existing Roam group. Approval by default
- WriteAdd Reaction to MessageAdd an emoji reaction to a message in a chat. Approval by default
- WriteCreate GroupCreate a group address that can be used for chat. Approval by default
- WriteCreate Roam SCIM GroupCreate a new group in your Roam organization using SCIM 2.0. Approval by default
- WriteCreate Roam UserCreate a new user in Roam via SCIM 2.0 protocol for automated user provisioning. Approval by default
- WriteDelete Roam GroupArchive a group in Roam using SCIM 2.0 protocol. Approval by default
- WriteDelete Roam UserArchive a user in Roam using SCIM 2.0 protocol. Approval by default
- WritePatch a groupPartially updates a group using SCIM 2.0 protocol. Approval by default
- WritePatch user (SCIM)Partially updates a user using SCIM 2.0 protocol. Approval by default
- WritePost message to chatPost a message to a chat. Approval by default
- WriteRemove group membersRemove one or more members from a group in your Roam workspace. Approval by default
- WriteReplace Roam SCIM GroupFully replaces a group's attributes using SCIM 2.0 protocol. Approval by default
- WriteReplace Roam UserFully replaces (updates) a user's attributes in Roam via SCIM 2.0 protocol. Approval by default
- WriteSend message to groupSends the given message to the specified recipients. Approval by default
- WriteSend Typing IndicatorNotify other chat participants that you are typing. Approval by default
- WriteUpdate a meeting linkUpdate settings for an existing meeting link in Roam. Approval by default
- WriteUpload File to RoamUpload a file to Roam so it can be sent as a chat attachment. Approval by default
One prompt, start to finish
What a governed Roam run looks like inside Luumen.
Questions
Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.
Read actions answer immediately. Anything that writes — add group members, add reaction to message, create group, create roam scim group, and more — is shown as a plan and requires approval by default, including the 3 actions classified as destructive. Administrators configure that per tool, so you decide exactly which actions can ever run unattended.
You decide. Actions are granted per agent, skill, and team, and per environment — production is not staging. Read access can be broad while writes stay narrow.
Every call to Roam — read or write, approved or declined — is recorded with the actor, the input, and the result, and can be linked to the ticket or change record.
Often connected alongside
All integrations
SlackRead the incident thread; post updates and approvals back.
GmailVendor and alert mail as context; replies drafted for review.
Microsoft TeamsRead Teams channels and chats for context, then make membership changes as approved steps.
DiscordRead Discord command permissions and app context, then change them with approvalPut Roam to work with Luumen
Connect in minutes. Every action scoped, approved, and audited from day one.