メインコンテンツへスキップ
POST
/
integration_mappings
/
slack
cURL
curl -X -L POST "https://api.box.com/2.0/integration_mappings/slack" \
     -H "authorization: Bearer <ACCESS_TOKEN>" \
     -H 'content-type: application/json' \
     -d '{
          "partner_item": {
              "id": "C987654321",
              "type": "channel",
              "slack_workspace_id": "T5555555"
          },
          "box_item": {
              "id": "123456789",
              "type": "folder"
          }
      }'
{
  "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"
}
このリソースは、バージョン2024.0のエンドポイントで使用されています。 詳細については、 Box APIのバージョン管理を参照してください。「Box SDKのバージョニング戦略について詳しく学ぶ。」

Authorizations

​
Authorization
string
header
required

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

Body

application/json

Slack統合マッピングオブジェクトを作成するリクエスト。

​
partner_item
Slackタイプの統合マッピングのマッピングされた項目スキーマ · object
required

Slackタイプの統合マッピングのマッピングされた項目オブジェクトのスキーマ。

Box for Slackがオーガナイゼーションレベルとワークスペースレベルのどちらでインストールされているかに応じて、slack_org_idまたはslack_workspace_idのいずれかを指定します。両方のパラメータを同時に使用しないでください。

​
box_item
Slackタイプの統合マッピングのBox項目スキーマ · object
required

Slackタイプの統合マッピングのBox項目オブジェクトのスキーマ。

​
options
Slackタイプ用の統合マッピングオプション · object

Slackタイプの統合マッピングオプションオブジェクトのスキーマ。

Response

作成された統合マッピングを返します。

統合マッピングオブジェクトのSlack固有のレプリゼンテーション。 統合マッピングオブジェクトのBase版の表示。

​
id
string
required

フォルダマッピングの一意の識別子 (integration_typeとともに複合キーの一部)。

Example:

"12345"

​
type
enum<string>
required

マッピングタイプ。

利用可能なオプション:
integration_mapping
Example:

"integration_mapping"

​
partner_item
Slackタイプの統合マッピングのマッピングされた項目スキーマ · object
required

Slack用にマッピングされた項目オブジェクト。

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

パートナーアプリのドメインのオブジェクト (partner_item_idで参照) のマッピング先であるBoxフォルダ。

​
integration_type
enum<string>

マッピングが関連付けられているBoxパートナーアプリを示します。現在サポートされているのはSlackのみです (idとともに複合キーの一部)。

利用可能なオプション:
slack
Example:

"slack"

​
is_manually_created
boolean

マッピングが (自動作成されたのではなく) 手動で設定されているかどうかを示します。

Example:

true

​
options
Slackタイプ用の統合マッピングオプション · object

Slackタイプの統合マッピングオプションオブジェクトのスキーマ。

​
created_by
ユーザー (統合マッピング) · object

統合マッピングを作成したユーザーを表すオブジェクト。

​
modified_by
ユーザー (統合マッピング) · object

統合マッピングを最後に変更したユーザー。

​
created_at
string<date-time>

統合マッピングオブジェクトが作成された日時。

Example:

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

​
modified_at
string<date-time>

統合マッピングオブジェクトが最後に変更された日時。

Example:

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