トリガータイプがWORKFLOW_MANUAL_START
のフローを開始します。
アプリケーションは、開発者コンソールでのManage Box Relay
アプリケーションスコープの使用が承認されている必要があります。
12345
ワークフローのID。
"workflow_parameters"
パラメータオブジェクトのタイプ
次の値に固定: workflow_parameters
ワークフローが開始されるファイルの配列。すべてのファイルは、ワークフローの設定済みフォルダに存在する必要があります。
"12345678"
ファイルのID
"file"
ファイルオブジェクトのタイプ
次の値に固定: file
トリガーされるフロー
"123456789"
フローのID
"flow"
フローオブジェクトのタイプ
ワークフローが設定されているフォルダオブジェクト。
"87654321"
フォルダのID
"folder"
フォルダオブジェクトのタイプ
次の値に固定: folder
ワークフローで完了する必要がある設定可能な結果。
"17363629"
特定の結果のID
ワークフローの結果の影響を受けたコラボレータのリストを取得します。
"variable"
コラボレータオブジェクトタイプ。
次の値に固定: variable
"user_list"
コラボレータオブジェクトの変数タイプ。
次の値に固定: user_list
ユーザーIDのリスト。
"636281"
ユーザーのID。
"user"
オブジェクトタイプ。
次の値に固定: user
操作をすべての担当者が完了する必要があるか、一人でも完了すればよいかを決定します。
"variable"
完了ルールオブジェクトタイプ。
次の値に固定: variable
"task_completion_rule"
完了ルールオブジェクトの変数タイプ。
次の値に固定: task_completion_rule
"all_assignees"
完了ルールの変数値。
次の値のいずれか1つ: all_assignees
,any_assignees
特定のコラボレータの役割がファイルに関するワークフローの結果の影響を受けるかどうかを決定します。
"variable"
役割オブジェクトタイプ。
次の値に固定: variable
"collaborator_role"
オブジェクトで使用される変数タイプ。
次の値に固定: collaborator_role
"editor"
役割パラメータに使用できる変数値。
次の値のいずれか1つ: editor
,viewer
,previewer
,uploader
,previewer uploader
,viewer uploader
,co-owner
特定のコラボレータの役割がワークフローの結果の影響を受けるかどうかを決定します。
"variable"
役割オブジェクトタイプ。
次の値に固定: variable
"collaborator_role"
オブジェクトで使用される変数タイプ。
次の値に固定: collaborator_role
"editor"
役割パラメータに使用できる変数値。
次の値のいずれか1つ: editor
,viewer
,previewer
,uploader
,previewer uploader
,viewer uploader
,co-owner
タスクのワークフローの結果の影響を受けたコラボレータのリストを取得します。
"variable"
コラボレータオブジェクトタイプ。
次の値に固定: variable
"user_list"
コラボレータオブジェクトの変数タイプ。
次の値に固定: user_list
ユーザーIDのリスト。
"636281"
ユーザーのID。
"user"
オブジェクトタイプ。
次の値に固定: user
ワークフローを開始します。
パラメータが不足しているか無効の場合はエラーを返します。
workflow_is_not_enabled
workflow_not_active_on_provided_folder
parameters_provided_do_not_match_target_outcome
権限が不足している場合にエラーを返します。
insufficient_access
missing_relay_full_access
ワークフローが見つからない場合、または認証済みユーザーがワークフローにアクセスできない場合はエラーを返します。
workflow_not_found
flow_missing_or_inaccessible
予期しないクライアントエラー。
curl -i -X POST "https://api.box.com/2.0/workflows/42037322/start" \
-H "authorization: Bearer <ACCESS_TOKEN>" \
-d '{
"type": "workflow_parameters",
"flow": {
"id": "8937625",
"type": "flow"
},
"files": [{
"type": "file",
"id": "389047572"
},
{
"type": "file",
"id": "389047578"
}],
"folder": {
"id": "2233212",
"type": "folder"
},
"outcomes": [
{
"id": "34895783",
"type": "outcome",
"task_collaborators": {
"type": "variable",
"variable_type": "user_list",
"variable_value": [{ "type": "user", "id": "890273642" }]
},
"completion_rule": {
"type": "variable",
"variable_type": "task_completion_rule",
"variable_value": "all_assignees"
},
"file_collaborator_role": {
"type": "variable",
"variable_type": "collaborator_role",
"variable_value": "viewer"
}
}
]
}'