Box Developer Documentation
Log in
 
    Beta

    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

    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"
      }
    }
  ]
}