リクエスト本文に基づいてワークフローを開始

post
https://api.box.com/2.0
/workflows/:workflow_id/start

トリガータイプがWORKFLOW_MANUAL_STARTのフローを開始します。

アプリケーションは、開発者コンソールでのManage Box Relayアプリケーションスコープの使用が承認されている必要があります。

リクエスト

bearer [ACCESS_TOKEN]
application/json

パスパラメータ

stringパス内必須
12345

ワークフローのID。

リクエスト本文

string本文内省略可能
"workflow_parameters"

パラメータオブジェクトのタイプ

次の値に固定: workflow_parameters

object array本文内必須

ワークフローが開始されるファイルの配列。すべてのファイルは、ワークフローの設定済みフォルダに存在する必要があります。

string本文内省略可能
"12345678"

ファイルのID

string本文内省略可能
"file"

ファイルオブジェクトのタイプ

次の値に固定: file

object本文内

トリガーされるフロー

string本文内必須
"123456789"

フローのID

string本文内必須
"flow"

フローオブジェクトのタイプ

object本文内

ワークフローが設定されているフォルダオブジェクト。

string本文内必須
"87654321"

フォルダのID

string本文内必須
"folder"

フォルダオブジェクトのタイプ

次の値に固定: folder

object array本文内省略可能

開始時に設定する必要がある結果のリスト。

string本文内省略可能
"890375782"

結果のID

string本文内省略可能
"outcome"

結果オブジェクトのタイプ

次の値に固定: outcome

string本文内省略可能
"placeholder"

これは、渡すことができるさまざまなオブジェクトを表すプレースホルダの例です。詳細については、ガイドセクションを参照してください。

レスポンス

none

ワークフローを開始します。

パラメータが不足しているか無効の場合はエラーを返します。

  • ワークフローが有効でない場合はworkflow_is_not_enabled
  • 指定されたフォルダIDに対してワークフローが有効でない場合はworkflow_not_active_on_provided_folder
  • 指定されたパラメータが予期されたパラメータと一致しない場合はparameters_provided_do_not_match_target_outcome

権限が不足している場合にエラーを返します。

  • ユーザーにファイルまたはフォルダへのアクセス権限がない場合はinsufficient_access
  • ユーザーにRelay全体へのアクセス権限がない場合はmissing_relay_full_access

ワークフローが見つからない場合、または認証済みユーザーがワークフローにアクセスできない場合はエラーを返します。

  • ワークフローが見つからない場合はworkflow_not_found
  • フローが手動開始フローでない場合はflow_missing_or_inaccessible

予期しないクライアントエラー。

post
リクエスト本文に基づいてワークフローを開始
このドキュメント内で一部のAPIを試せるようになりました。
ログイン

リクエストの例

cURL
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"
            }
          }
        ]
     }'