Box Developer Documentation

Integration mapping Teams

This resource is used by enpoints in the version 2024.0. For more details, see Box API versioning.

A Microsoft Teams specific representation of an integration mapping object.

string
12345

A unique identifier of a folder mapping (part of a composite key together with integration_type)

string
integration_mapping

Mapping type

Value is always integration_mapping

object

The Box folder, to which the object from the partner app domain (referenced in partner_item_id) is mapped

42037322

ID of the folder

folder

folder

Value is always folder

string (date-time)
2012-12-12T10:53:43-08:00

When the integration mapping object was created

teams

Identifies the Box partner app, with which the mapping is associated. Supports Slack and Teams. (part of the composite key together with id)

Value is always teams

true

Identifies whether the mapping has been manually set by the team owner from UI for channels (as opposed to being automatically created)

string (date-time)
2012-12-12T10:53:43-08:00

When the integration mapping object was last modified

object object
{"id":"19%3ABCD-Avgfggkggyftdtfgghjhkhkhh%40thread:tacv2","team_id":"hjgjgjg-bhhj-564a-b643-hghgj685u","tenant_id":"E1234567","type":"channel"}

Mapped item object for Teams

Response Example

{
  "id": "12345",
  "type": "integration_mapping",
  "box_item": {
    "id": "42037322",
    "type": "folder"
  },
  "created_at": "2012-12-12T10:53:43-08:00",
  "integration_type": "teams",
  "is_overridden_by_manual_mapping": true,
  "modified_at": "2012-12-12T10:53:43-08:00",
  "partner_item": {
    "id": "19%3ABCD-Avgfggkggyftdtfgghjhkhkhh%40thread:tacv2",
    "type": "channel",
    "team_id": "hjgjgjg-bhhj-564a-b643-hghgj685u",
    "tenant_id": "E1234567"
  }
}