メインコンテンツへスキップ
POST
cURL
このリソースは、バージョン2024.0のエンドポイントで使用されています。 詳細については、 Box APIのバージョン管理を参照してください。「Box SDKのバージョニング戦略について詳しく学ぶ。」

承認

Authorization
string
header
必須

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

ボディ

application/json
item
object
必須

タスクを添付するファイル。

action
enum<string>
デフォルト:review

タスク担当者が実行を求められるアクション。次のいずれかを指定する必要があります。

  • review - 承認または拒否できる承認タスクを定義します。
  • complete - 完了できる一般タスクを定義します。
利用可能なオプション:
review,
complete
例:

"review"

message
string
デフォルト:""

タスクに含めるメッセージ (省略可)。

例:

"Please review"

due_at
string<date-time>

タスクの期限を定義します。指定しない場合は、デフォルトでnullに設定されます。

例:

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

completion_rule
enum<string>
デフォルト:all_assignees

タスクが完了と見なされる前にそのタスクを完了する必要がある担当者を定義します。

  • all_assignees (デフォルト) - タスクが完了と見なされるには、すべての担当者がそのタスクをレビューまたは承認する必要があります。
  • any_assignee - いずれか1人の担当者がタスクをレビューまたは承認すれば、タスクが完了と見なされます。
利用可能なオプション:
all_assignees,
any_assignee
例:

"all_assignees"

レスポンス

新しく作成されたタスクを返します。

タスクを使用すると、Boxでファイル中心のワークフローを実現できます。ユーザーはファイルに関連するタスクを作成し、タスクを完了するために他のユーザーに割り当てることができます。

id
string

このタスクの一意の識別子。

例:

"11446498"

type
enum<string>

値は常にtaskになります。

利用可能なオプション:
task
例:

"task"

item
ファイル (Mini) · object | null

タスクに関連付けられたファイル。

due_at
string<date-time>

タスクの期限。

例:

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

action
enum<string>

タスク担当者が実行するように求められるタスクのタイプ。

利用可能なオプション:
review,
complete
例:

"review"

message
string

タスクに含めるメッセージ。

例:

"Legal review"

task_assignment_collection
タスク割り当て · object

タスクに関連付けられたタスク割り当てオブジェクトのコレクション。

is_completed
boolean

タスクが完了しているかどうか。

例:

true

created_by
ユーザー (Mini) · object

タスクを作成したユーザー。

created_at
string<date-time>

タスクオブジェクトが作成された日時。

例:

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

completion_rule
enum<string>

タスクが完了と見なされる前にそのタスクを完了する必要がある担当者を定義します。

  • all_assignees - タスクが完了と見なされるには、すべての担当者がそのタスクをレビューまたは承認する必要があります。
  • any_assignee - いずれか1人の担当者がタスクをレビューまたは承認すれば、タスクが完了と見なされます。
利用可能なオプション:
all_assignees,
any_assignee
例:

"all_assignees"

最終更新日 2026年1月23日