ceven

Roam

Syncs secure chat streams and meeting transcripts into your knowledge base and automates user provisioning across your organization.

Try Roam in Ceven

Ask Ceven anything
Standard

Why use Ceven?

  1. AI native Roam integration

    • Describe the outcome and Ceven picks the right Roam calls, fills the parameters, and checks the result.
    • Structured, agent friendly tool schemas so each call runs reliably instead of by guesswork.
    • Rich coverage for reading, writing, and querying your Roam data, across all 39 of its actions.

  2. Managed auth

    • Built in OAuth with automatic token refresh and rotation.
    • One place to manage, scope, and revoke Roam access.
    • Per user and per environment credentials instead of shared keys.

  3. Agent optimized design

    • Actions are tuned from real success and error rates so reliability climbs over time.
    • Full execution logs so you always know what ran in Roam, when, and on whose behalf.
    • The agent pauses and asks when Roam is unclear instead of plowing ahead.

  4. Enterprise grade security

    • Fine grained access so you control which agents and people can reach Roam.
    • Least privilege by default, read scopes first and only the writes a workflow needs.
    • A full audit trail of every Roam action to support review and sign off.

Supported tools

Every action Ceven's agents can run on Roam, and when to use it.

Post message
Use this to send markdown or rich block layouts to a chat, group, or specific user.
Get chat history
Pull messages from a specific chat filtered by date range to analyze past conversations.
Create group
Use this to spin up a new chat group with optional admin settings for restricted management.
Add group members
Add users or promote existing members to admin status within a Roam group.
Create user
Provision a new user in the organization using the SCIM 2.0 protocol.
List users
Pull a list of all users in the workspace with optional status and email fields.
Lookup user by email
Find a specific user ID and profile details using their primary email address.
Get meeting link
Retrieve the specific URL and details for a scheduled meeting by its ID.
List transcripts
Pull a list of all meeting transcripts filtered by date for archival or analysis.
Upload file
Upload a document or image to Roam to get an item ID for chat attachments.
List audit logs
Pull user audit log entries for security monitoring and compliance reviews.
Remove group members
Use this to offboard users from a specific group while keeping them in the org.
Add Reaction to Message
Add an emoji reaction to a message in a chat. Use this action when you want to react to a message with an emoji in a Roam chat. The action requires the message ID, chat ID, reaction name, and timestamp. Required scope: chat:send_message or
Create Roam SCIM Group
Tool to create a new group in your Roam organization using SCIM 2.0. Use when you need to provision a new group for managing user access and permissions via the SCIM 2.0 protocol. The displayName is required and must be 64 characters or les
Create Roam User
Create a new user in Roam via SCIM 2.0 protocol for automated user provisioning. Use when you need to add a new user to your Roam organization. The userName must match the primary email address exactly. The role defaults to 'User' but can b
Delete Roam Group
Archive a group in Roam using SCIM 2.0 protocol. This is a soft delete operation that archives the group. Use when you need to archive a group that is no longer needed while preserving data for audit purposes. Returns 204 No Content on succ
Delete Roam User
Archive a user in Roam using SCIM 2.0 protocol. This is a soft delete operation that deprovisions the user. Use when you need to remove a user from the organization while preserving their data for audit purposes. Returns 204 No Content on s
Get Address Info
Get 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. Use this action to retrieve details like display name, email, profile image, and other information about
Get Roam SCIM Resource Types
Returns the list of SCIM 2.0 resource types supported by Roam. Use this action to discover what resource types are available in the Roam SCIM API. Currently returns User and Group resource types. This endpoint requires no parameters.
Get SCIM service provider config
Tool to retrieve Roam's SCIM service provider configuration. Use when you need to discover Roam's SCIM API capabilities including supported authentication schemes, bulk operations, filtering, and other service provider features. This endpoi
Get SCIM schema
Retrieves the definition of a specific SCIM 2.0 schema by its unique identifier (URN). This endpoint returns the complete schema definition including all attributes, their types, mutability, and other properties. Common schemas include: - u
Get user by ID (SCIM)
Tool to retrieve a single user by their Roam Person ID using SCIM 2.0 protocol. Use when you need to get detailed information about a specific user including their name, email, active status, and role in Roam. The user ID is the SCIM user I
Test API Connectivity
Test endpoint for API connectivity. Use this endpoint to verify that the Roam API is accessible and authentication is working correctly. Returns a confirmation message on successful connection.
Get token info
Retrieves information about the current Roam access token. Use this tool to: - Get the bot's chat address - Check the OAuth scopes granted to the current token - Retrieve information about the associated Roam workspace Returns the chat addr
Get user info
Get detailed information about a single user in your Roam workspace. Requires user:read scope. Additional scopes (user:read.email, user:read.status) needed for expanded fields.
List Roam Chats
Lists all accessible chats, which consist of all DMs, MultiDMs, and Channels that your bot has been added to, in addition to all public channels. Supports pagination via cursor and limiting the number of results. Use this action to discover
List group members
List members in a group in your Roam workspace. Use this tool when: - You need to see all members of a specific group - You want to check who has access to a group - You need to paginate through large groups Access conditions: - The group m
List SCIM Groups
Returns a paginated list of groups in your Roam organization via SCIM 2.0. Use when you need to retrieve all groups in your Roam organization using the SCIM protocol. Supports pagination using startIndex and count parameters. Note: The filt
List Roam Lobbies
Lists active lobbies in your Roam account. Returns all lobby configurations with their IDs, display names, URLs, and active status. Use this action to discover available lobbies before performing operations on them.
List Roam Meetings
Lists all meetings in your home Roam, filtered by date range. Supports pagination via cursor and limiting the number of results. Returns meeting details including meeting ID, room, time, and participants. Use this action to discover availab

30 actions · scroll to see them all

Frequently asked questions

Ceven uses OAuth 2.0 to access Roam, meaning we never see your password. You grant specific scopes during the connection process, such as user read or chat write. The agent can only interact with the chats and groups that the authenticated bot user has permission to see. If the bot is not added to a private group, it cannot read those messages or post to that group. All tokens are encrypted at rest and rotated regularly to ensure that your secure communication remains private. You can revoke access instantly from the Roam admin panel, which kills the session and stops all active workflows immediately.
Yes. By leveraging the SCIM 2.0 endpoints, Ceven can connect your HR system to Roam. When a new hire is added to your payroll or identity provider, the agent can automatically call the Create Roam User action. It can then assign them to the necessary default groups and send a welcome message via a direct chat. This ensures that every new employee has the right access levels from day one without a manual request to the IT team. It also handles offboarding by archiving users through the SCIM delete operation to preserve audit data.
One important quirk of the Roam API is that the bot must be an active member of a chat or group to retrieve its history. If you attempt to pull messages from a group where the bot was never added, the API will return an empty set or an access error. Additionally, Roam enforces strict rate limits on history requests to prevent bulk scraping. If a workflow tries to pull years of data in a single loop, you may encounter 429 errors. Ceven manages this by implementing an exponential backoff strategy and using pagination cursors to fetch data in smaller, safe chunks.
Uploading files is a two step process in Roam. First, the agent uses the Upload File action to send the binary data to Roam servers, which returns a unique item ID. Second, the agent must include that item ID in a Post Message call to actually make the file visible to users in a chat. Ceven handles this sequencing automatically. If you tell the agent to send a report from Google Drive to Roam, it downloads the file, uploads it to Roam, and then posts the resulting attachment link into the designated channel in one seamless motion.
Ceven can implement this by polling the chat history or reacting to webhook events if configured. You can set up a workflow that checks for words like urgent or critical every few minutes. When a match is found, the agent can trigger a secondary action, such as paging an engineer via PagerDuty or creating a ticket in Jira. Because Roam supports rich block layouts, the agent can also post a formatted confirmation message back into the chat to let the team know that the alert has been acknowledged and a ticket has been created.
Yes. The agent can create, retrieve, and update meeting links. This is particularly useful for recurring syncs or emergency war rooms. For example, you can build a workflow that generates a new Roam meeting link every Monday morning and posts it to the team channel. If the meeting time changes in your calendar, the agent can call the Update Meeting Link action to synchronize the time in Roam. This prevents the confusion of team members joining the wrong room or using expired links during time sensitive operations.
Ceven can automate the archival of Roam transcripts to meet regulatory requirements. The agent can be scheduled to list all transcripts at the end of each business day. It then pulls the full text and metadata, including participants and timestamps, and pushes that data into a secure storage bucket or a compliance tool like Vanta. This ensures that you have a permanent, immutable record of all professional communications without requiring users to manually export and upload their meeting notes after every single call.
Absolutely. The agent can add or remove members from groups based on external triggers. For instance, if a user changes their department in your CRM, Ceven can automatically remove them from their old Roam groups and add them to the new ones. It can also promote users to admin status if they are flagged as managers in your identity provider. This keeps your communication silos clean and ensures that sensitive information is only accessible to the people who currently need it for their specific role.

Alternatives to Roam

Other tools that solve a similar problem. Ceven supports these too, so you can switch or run more than one at once.

Slack logoSlackMicrosoft Teams logoMicrosoft TeamsDiscord logoDiscord

Try Ceven on your stack

Plug Ceven on top of the tools you already run. Connect Roam and the rest of your stack, describe the outcome, and its agents handle the work end to end, days of it in minutes.

Get started for free