--- title: "Update Slack integration mapping" method: PUT path: "/integration_mappings/slack/{integration_mapping_id}" tags: ["Integration mappings"] --- # Update Slack integration mapping `PUT /integration_mappings/slack/{integration_mapping_id}` Updates a [Slack integration mapping](https://support.box.com/hc/en-us/articles/4415585987859-Box-as-the-Content-Layer-for-Slack). 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` IntegrationMappingBoxItemSlack — The schema for an integration mapping Box item object for type Slack. - `type` 'folder', required — Type of the mapped item referenced in `id`. - `id` string, required — ID of the mapped item (of type referenced in `type`). - `options` IntegrationMappingSlackOptions — The schema for an integration mapping options object for Slack type. - `is_access_management_disabled` boolean — Indicates whether or not channel member access to the underlying box item should be automatically managed. Depending on type of channel, access is managed through creating collaborations or shared links. ## Response `200` Returns the updated integration mapping object. - IntegrationMapping — 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` 'slack' — Identifies the Box partner app, with which the mapping is associated. Currently only supports Slack. (part of the composite key together with `id`). - `is_manually_created` boolean — Identifies whether the mapping has been manually set (as opposed to being automatically created). - `options` IntegrationMappingSlackOptions — The schema for an integration mapping options object for Slack type. - `is_access_management_disabled` boolean — Indicates whether or not channel member access to the underlying box item should be automatically managed. Depending on type of channel, access is managed through creating collaborations or shared links. - `created_by` UserIntegrationMappings — A mini representation of a user, used when nested within another resource. - `id` string, required — The unique identifier for this user. - `type` 'user', required — The value will always be `user`. - `name` string — The display name of this user. - `login` string, email — The primary email address of this user. - `modified_by` UserIntegrationMappings — A mini representation of a user, used when nested within another resource. - `id` string, required — The unique identifier for this user. - `type` 'user', required — The value will always be `user`. - `name` string — The display name of this user. - `login` string, email — The primary email address of this user. - `partner_item` IntegrationMappingPartnerItemSlack, required — The schema for an integration mapping mapped item object for type Slack. Depending if Box for Slack is installed at the org or workspace level, provide **either** `slack_org_id` **or** `slack_workspace_id`. Do not use both parameters at the same time. - `type` 'channel', required — Type of the mapped item referenced in `id`. - `id` string, required — ID of the mapped item (of type referenced in `type`). - `slack_workspace_id` string, nullable — ID of the Slack workspace with which the item is associated. Use this parameter if Box for Slack is installed at a workspace level. Do not use `slack_org_id` at the same time. - `slack_org_id` string, nullable — ID of the Slack org with which the item is associated. Use this parameter if Box for Slack is installed at the org level. Do not use `slack_workspace_id` at the same time. - `box_item` FolderMini, required — The bare basic representation of a folder, the minimal amount of fields returned when using the `fields` query parameter. - `id` string, required — The unique identifier that represent a folder. The ID for any folder can be determined by visiting a folder in the web application and copying the ID from the URL. For example, for the URL `https://*.app.box.com/folders/123` the `folder_id` is `123`. - `etag` string, nullable — The HTTP `etag` of this folder. This can be used within some API endpoints in the `If-Match` and `If-None-Match` headers to only perform changes on the folder if (no) changes have happened. - `type` 'folder', required — The value will always be `folder`. - `sequence_id` string — A numeric identifier that represents the most recent user event that has been applied to this item. This can be used in combination with the `GET /events`-endpoint to filter out user events that would have occurred before this identifier was read. An example would be where a Box Drive-like application would fetch an item via the API, and then listen to incoming user events for changes to the item. The application would ignore any user events where the `sequence_id` in the event is smaller than or equal to the `sequence_id` in the originally fetched resource. - `name` string — The name 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, * `JWT_APP_NOT_AUTHORIZED` - JWT authorization error. - `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)