Skip to main content
PUT
/
integration_mappings
/
slack
/
{integration_mapping_id}
cURL
curl -X -L PUT "https://api.box.com/2.0/integration_mappings/slack/512521" \
     -H "authorization: Bearer <ACCESS_TOKEN>"  \
     -H 'content-type: application/json'  \
     -d'{
         "options": {
            "is_access_management_disabled": true
        }
    }'
{
  "id": "12345",
  "type": "integration_mapping",
  "partner_item": {
    "id": "C12378991223",
    "type": "channel",
    "slack_org_id": "E1234567"
  },
  "box_item": {
    "id": "12345",
    "type": "folder",
    "etag": "1",
    "sequence_id": "3",
    "name": "Contracts"
  },
  "integration_type": "slack",
  "is_manually_created": true,
  "options": {
    "is_access_management_disabled": true
  },
  "created_by": {
    "id": "11446498",
    "type": "user",
    "name": "Aaron Levie",
    "login": "ceo@example.com"
  },
  "modified_by": {
    "id": "11446498",
    "type": "user",
    "name": "Aaron Levie",
    "login": "ceo@example.com"
  },
  "created_at": "2012-12-12T10:53:43-08:00",
  "modified_at": "2012-12-12T10:53:43-08:00"
}

Documentation Index

Fetch the complete documentation index at: https://developer.box.com/llms.txt

Use this file to discover all available pages before exploring further.

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

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
integration_mapping_id
string
required

An ID of an integration mapping.

Body

application/json

At least one of box_item and options must be provided.

​
box_item
Integration mapping Box item schema for type Slack · object

The schema for an integration mapping Box item object for type Slack.

​
options
Integration mapping options for type Slack · object

The schema for an integration mapping options object for Slack type.

Response

Returns the updated integration mapping object.

A Slack specific 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).

Example:

"12345"

​
type
enum<string>
required

Mapping type.

Available options:
integration_mapping
Example:

"integration_mapping"

​
partner_item
Integration mapping mapped item schema for type Slack · object
required

Mapped item object for Slack.

Example:
{
  "id": "C12378991223",
  "type": "channel",
  "slack_org_id": "E1234567"
}
​
box_item
Folder (Mini) · object
required

The Box folder, to which the object from the partner app domain (referenced in partner_item_id) is mapped.

​
integration_type
enum<string>

Identifies the Box partner app, with which the mapping is associated. Currently only supports Slack. (part of the composite key together with id).

Available options:
slack
Example:

"slack"

​
is_manually_created
boolean

Identifies whether the mapping has been manually set (as opposed to being automatically created).

Example:

true

​
options
Integration mapping options for type Slack · object

The schema for an integration mapping options object for Slack type.

​
created_by
User (Integration Mappings) · object

An object representing the user who created the integration mapping.

​
modified_by
User (Integration Mappings) · object

The user who last modified the integration mapping.

​
created_at
string<date-time>

When the integration mapping object was created.

Example:

"2012-12-12T10:53:43-08:00"

​
modified_at
string<date-time>

When the integration mapping object was last modified.

Example:

"2012-12-12T10:53:43-08:00"