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

post

https://api.box.com/2.0

/workflows/:workflow_id/start

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

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

リクエスト

authorizationbearer [ACCESS_TOKEN]

content-typeapplication/json

パスパラメータ

workflow_id stringパス内必須

例"12345"

ワークフローのID。

リクエスト本文

type string本文内省略可能

例"workflow_parameters"

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

次の値に固定: workflow_parameters

files object array本文内必須

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

[files].id string本文内省略可能

例"12345678"

ファイルのID

[files].type string本文内省略可能

例"file"

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

次の値に固定: file

flow object本文内

トリガーされるフロー

flow.id string本文内必須

例"123456789"

フローのID

flow.type string本文内必須

例"flow"

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

folder object本文内

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

folder.id string本文内必須

例"87654321"

フォルダのID

folder.type string本文内必須

例"folder"

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

次の値に固定: folder

outcomes object array本文内省略可能

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

[outcomes].id string本文内省略可能

例"890375782"

結果のID

[outcomes].type string本文内省略可能

例"outcome"

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

次の値に固定: outcome

[outcomes].parameter string本文内省略可能

例"placeholder"

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

レスポンス

204none

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

400application/jsonクライアントエラー

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

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

403application/jsonクライアントエラー

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

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

404application/jsonクライアントエラー

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

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

defaultapplication/jsonクライアントエラー

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

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