DocumentationBlogSupport
Log inSign up
Log inSign up
BlogSupport

New Webex Room Tabs API

July 6, 2021
Dirk-Jan Uittenbogaard
Dirk-Jan UittenbogaardTechnical Solutions Architect at Cisco Systems
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?".

When you click a tab one more time a menu appears with the following options:

Room Tabs Menu Options

You can also move the space tab into a separate window by clicking the icon marked here:

Separate Window Icon

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!

Blog Categories
  • Product Announcements
  • How To
  • Events
  • Developer Stories
Share This Article

Connect

Support

Developer Events

Contact Sales

Handy Links

Webex Ambassadors

Webex App Hub

Resources

Open Source Bot Starter Kits

Download Webex

DevNet Learning Labs

Terms of Service

Privacy Policy

Cookie Policy

Trademarks

© 2023 Cisco and/or its affiliates. All rights reserved.