New Webex Room Tabs API

Room Tabs represent an always available tab that is added to a space, and are configured with a content URL. Just like in the Webex app, you must be a member of the space in order to see its Room Tabs.

What to use these for?

• In your team space: add a tab with your team intranet page.
• In a finance space: add a tab with a specific Smartsheet.
• For an event space: add tabs for event project management tools.
• For file access: add box.com tab to see files or a folder in a space.
• In brainstorming spaces: add a Miro tab.
• In a project space: add a Trello tab.

The same applies to any other web-based tool.

Authentication

When a login is required for URLs used in space tabs, you must login. Tools that use Single Sign On will make life easier. Think "do all members of this space have access to the page shown in this tab?".

Room Tab API call

When viewing all space tabs using the room tabs API, you can expect something like this:

{
  "items": [
    {
      "id": "Y2lzYGFMDExZWYzOmNkZTGQtMTFlNS1iYTljLTdiNjU1NmQyMjA3Yg",
      "roomId": "Y2lzYGFyJP0JjZWImMS0zYjU4LTkxNDctZjE0YmIwYzRkMTU0",
      "roomType": "group",
      "displayName": "Project Management HomePage",
      "contentUrl": "https://int.cisco.com/projectmanager/233210119",
      "creatorId": "Y2lzY29IzNjE4Ny1jOGRkLTQ3MOGIyZi1mOWM0mMjkwNDY",
      "created": "2021-05-18T26:14:16"
    }
  ]
}

Where:

• id = the space tab ID
• roomId = space that the tab is visible in
• displayName = Title of the tab
• contentUrl = Tab content source URL
• creatorId = userId of the person who added the tab
• created = date & time

When creating a space tab, the following items are required:

• roomId
• contentUrl
• displayName

Besides creating room tabs, you can also remove/update/read them.

Be sure to check out the API docs for room-tabs at https://developer.webex.com/docs/api/v1/room-tabs. We are excited to see what you build!