v1

latestOpenAPI 3.0.2Apache-2.02026-07-142963051.0 MB

Integration mappings

Create Teams integration mapping

Creates a Teams integration mapping by mapping a Teams channel to a Box item. You need Admin or Co-Admin role to use this endpoint.

post/integration_mappings/teams

Request body

Example request

{
  "partner_item": {
    "type": "channel",
    "id": "19%ABCD-Avgfggkggyftdtfgghjhkhkhh%40thread:tacv2",
    "tenant_id": "abcd-defg-1235-7890",
    "team_id": "hjgjgjg-bhhj-564a-b643-hghgj685u"
  },
  "box_item": {
    "type": "folder",
    "id": "42037322"
  }
}

Response

Returns the created integration mapping.

idstring required

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

type'integration_mapping' required

Mapping type.

integration_type'teams'

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

is_overridden_by_manual_mappingboolean

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

created_atstring date-time

When the integration mapping object was created.

modified_atstring date-time

When the integration mapping object was last modified.

Example response

{
  "id": "12345",
  "type": "integration_mapping",
  "integration_type": "teams",
  "is_overridden_by_manual_mapping": true,
  "partner_item": {
    "type": "channel",
    "id": "19%ABCD-Avgfggkggyftdtfgghjhkhkhh%40thread:tacv2",
    "tenant_id": "abcd-defg-1235-7890"
  },
  "box_item": {
    "type": "folder",
    "id": "42037322"
  },
  "created_at": "2012-12-12T10:53:43-08:00",
  "modified_at": "2012-12-12T10:53:43-08:00"
}