Box Developer Documentation
Log in
Latest version

List Teams integration mappings

get
https://api.box.com/2.0
/integration_mappings/teams

This endpoint is in the version 2024.0. No changes are required to continue using it. For more details, see Box API versioning.

Lists Teams integration mappings in a users' enterprise. You need Admin or Co-Admin role to use this endpoint.

Related Guides

Request

bearer [ACCESS_TOKEN]
application/json

Query Parameters

stringin queryoptional
12345

Box item ID, for which the mappings should be returned.

stringin queryoptional
folder

Box item type, for which the mappings should be returned.

Value is always folder

stringin queryoptional
12345

ID of the mapped item, for which the mapping should be returned.

stringin queryoptional
channel

Mapped item type, for which the mapping should be returned.

Value is one of channel,team

Response

application/jsonIntegration mappings Teams

Returns a collection of integration mappings.

application/jsonClient error

The server cannot or will not process the request due to an apparent client error.

application/jsonClient error

Returns a not_found error if the integration mapping could not be found.

application/jsonClient error

An unexpected client error.

get
List Teams integration mappings
You can now try out some of our APIs live, right here in the documentation.
Log in

Request Example

Learn more about Box SDK versioning strategy.


cURL
curl -X -L GET "https://api.box.com/2.0/integration_mappings/teams" \
     -H "authorization: Bearer <ACCESS_TOKEN>" \
Node/TypeScript v10
await userClient.integrationMappings.getTeamsIntegrationMapping();
Python v10
user_client.integration_mappings.get_teams_integration_mapping()
.NET v10
await userClient.IntegrationMappings.GetTeamsIntegrationMappingAsync();
Swift v10
try await userClient.integrationMappings.getTeamsIntegrationMapping()
Java v10
userClient.getIntegrationMappings().getTeamsIntegrationMapping()

Response Example

{
  "entries": [
    {
      "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",
        "team_id": "hjgjgjg-bhhj-564a-b643-hghgj685u",
        "tenant_id": "E1234567",
        "type": "channel"
      }
    }
  ]
}