---
title: "Update Teams integration mapping"
method: PUT
path: "/integration_mappings/teams/{integration_mapping_id}"
tags: ["Integration mappings"]
---

# Update Teams integration mapping

`PUT /integration_mappings/teams/{integration_mapping_id}`

Updates a [Teams integration mapping](https://support.box.com/hc/en-us/articles/360044681474-Using-Box-for-Teams).
Supports updating the Box folder ID and options.
You need Admin or Co-Admin role to
use this endpoint.

## Path parameters

- `integration_mapping_id` string, required

## Request body

- object
  - `box_item` object — The Box folder, to which the object from the partner app domain is mapped.
    - `type` 'folder', required — The value will always be `folder`.
    - `id` string, required — ID of the folder.

## Response `200`

Returns the updated integration mapping object.

- IntegrationMappingTeams — A base representation of an integration mapping object.
  - `id` string, 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_mapping` boolean — Identifies whether the mapping has been manually set by the team owner from UI for channels (as opposed to being automatically created).
  - `partner_item` IntegrationMappingPartnerItemTeams, required — The schema for an integration mapping mapped item object for type Teams.
    - `type` 'channel' | 'team', required — Type of the mapped item referenced in `id`.
    - `id` string, required — ID of the mapped item (of type referenced in `type`).
    - `tenant_id` string, required — ID of the tenant that is registered with Microsoft Teams.
  - `box_item` object, required — The Box folder, to which the object from the partner app domain (referenced in `partner_item_id`) is mapped.
    - `type` 'folder', required — The value will always be `folder`.
    - `id` string, required — ID of the folder.
  - `created_at` string, date-time — When the integration mapping object was created.
  - `modified_at` string, date-time — When the integration mapping object was last modified.

## Other responses

- `400` — Returns a `bad_request` if an incorrect `options` was supplied or the Box folder cannot be mapped to this `partner_item`. Error codes: * `SERVICE_ACCOUNT_IS_NOT_A_COOWNER_OR_OWNER` - service account doesn't have co-owner collaboration or is not an owner of the `box_item_id`, * `BOX_FOLDER_EXTERNALLY_OWNED` - Box folder must be internally owned to the admin's enterprise, * `FOLDER_ALREADY_MAPPED` - Box folder must not be mapped to another integration mapping.
- `404` — Returns `not_found` if integration mapping object was not found.
- `default` — An unexpected client error.

---

[API](https://skmtc.net/box/apis/platform-api.md) · [All operations](https://skmtc.net/box/apis/platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/box/platform-api/revisions/ba8f087e1a4d/schema)