Getting Tabs

This section explains how to get a resource representation of a Microsoft Teams channel tab with a specified ID.

Request

GET https://<hostname>:4443/v5/RestoreSessions/{restoreSessionId}/organization/teams/{teamId}/channels/{channelId}/tabs/{tabId}

Request Headers

The request header must contain an authorization token of the current session.

Request Body

None.

Response

The server returns the following response to the client.

Response Codes

A successfully completed operation returns a response code 200 (OK).

Response Headers

The response to this request contains the following headers. The response may also include additional standard HTTPS headers.

Header

Description

Content-length

The length of the response body.

Content-type

The media type and syntax of the response body message: application/json; charset=utf-8

Response Body

In the response body, the server returns a representation of the /RestoreSessions/{restoreSessionId}/organization/teams/{teamId}/channels/{channelId}/tabs/{tabId} resource. The response body contains the following parameters:

Property

Type

Description

Id

string

ID of the backed-up tab.

DisplayName

string

Display name of the backed-up tab.

ContentURL

string

URL address of the object published on the backed-up tab.

Type

string

Type of the backed-up tab. Possible values:

  • Website 
  • Planner
  • Word
  • Excel
  • PowerPoint
  • Visio
  • PDF
  • Document Library
  • OneNote (restore for tabs of this type is not supported)
  • SharePoint
  • Stream
  • Forms
  • Power BI
  • Flow
  • Azure DevOps

_links

Dictionary of string [key] and Object [value]

Links to related resources (navigation property).

Example

The following request returns a representation of a channel tab with the ID 854dde06-0935-47f4-8e36-3c65f9f8cb89.

Request:

GET https://abc.tech.local:4443/v5/RestoreSessions/b23ba83e-e45c-4615-97ab-190f506c643e/organization/teams/448c5b66-8dcd-4c75-b636-d3b500bce36f/channels/19%3A94e57dbfaa634f999353b374b69b5800%40thread.tacv2/tabs/854dde06-0935-47f4-8e36-3c65f9f8cb89

 

Request Header:

Authorization: Bearer <Access-Token>

 

Response:

200 OK

 

Response Body:

{

 "id": "854dde06-0935-47f4-8e36-3c65f9f8cb89",

 "displayName": "word",

 "contentUrl": "https://abc.sharepoint.com/sites/IT&Finance/Shared Documents/General/word.docx",

 "type": "Word",

 "_links": {

   "self": {

     "href": "https://abc.tech.local:4443/v5/restoresessions/b23ba83e-e45c-4615-97ab-190f506c643e/organization/teams/448c5b66-8dcd-4c75-b636-d3b500bce36f/channels/19:94e57dbfaa634f999353b374b69b5800@thread.tacv2/tabs/854dde06-0935-47f4-8e36-3c65f9f8cb89"

   },

   "channel": {

     "href": "https://abc.tech.local:4443/v5/restoresessions/b23ba83e-e45c-4615-97ab-190f506c643e/organization/teams/448c5b66-8dcd-4c75-b636-d3b500bce36f/channels/19:94e57dbfaa634f999353b374b69b5800@thread.tacv2"

   },

   "team": {

     "href": "https://abc.tech.local:4443/v5/restoresessions/b23ba83e-e45c-4615-97ab-190f506c643e/organization/teams/448c5b66-8dcd-4c75-b636-d3b500bce36f"

   }

 }

}

I want to report a typo

There is a misspelling right here:

 

I want to let the Veeam Documentation Team know about that.