POST/users/{userId}/tasks

ユーザーのマイタスクを登録する。

Authorization

oauth2

Access Token を指定します。
指定の方法や Access Token の取得方法は 共通仕様 を参照してください。

Scope

task

HTTP Request

POSThttps://www.worksapis.com/v1.0/users/{userId}/tasks

Path Parameters

ParameterTypeDescription
userId string 

ユーザー ID


required
example : userf7da-f82c-4284-13e7-030f3b4c756x 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Request Body

PropertyTypeDescription
assignorId string 

依頼者 ID


required 
assignees array (Assignee) 

タスクの担当者


required 
title string 

件名


required 
content string 

タスク内容


required 
dueDate string 

期限 (期限がある場合)

  • 形式: YYYY-MM-DD
  • 例: 2024-03-08

nullable : true 
completionCondition string 

完了条件

  • ANY_ONE: 担当者のうち誰か 1 人が完了
  • MUST_ALL: 担当者全員の完了が必要

注意

  • タスクの部分更新では、担当者が 2 人以上の場合にのみ指定できる。

required
Allowed values : ANY_ONE, MUST_ALL 
categoryId string 

ユーザーのタスクカテゴリー ID

 

Assignee

PropertyTypeDescription
assigneeId string 

担当者 ID
削除されたアカウントは空白で表示される。


required 
status string 

タスクの完了ステータス

  • DONE: 完了
  • TODO: 未完了

参考

  • 担当者を追加する場合には、常に TODO に設定する。
  • タスクの完了ステータスは、以下の API で変更する。
  • タスクの完了
  • タスクの完了取り消し
  • 自分のタスクの完了
  • 自分のタスクの完了取り消し

required
Allowed values : DONE, TODO 

Request Example

example

1{2  "assignorId": "userf7da-f82c-4284-13e7-030f3b4c756x",3  "assignees": [4    {5      "assigneeId": "userf7da-f82c-4284-13e7-030f3b4c756x",6      "status": "TODO"7    },8    {9      "assigneeId": "userf7da-f82c-4284-13e7-030f3b4c754x",10      "status": "TODO"11    }12  ],13  "title": "週次会議の予定",14  "content": "会議室の予約",15  "dueDate": "2024-05-25",16  "completionCondition": "ANY_ONE",17  "categoryId": "7f5078df-bf67-417c-a559-f5539e59bd0d"18}

Response

HTTP 201

Created

PropertyTypeDescription
task object (task) 

タスク

 

task

PropertyTypeDescription
assignees array (Assignee) 

担当者リスト

 
assignorId string 

依頼者 ID
削除されたアカウントは空白で表示される。

 
assignorName string 

依頼者名

 
completionCondition string 

完了条件

  • ANY_ONE: 担当者のうち誰か 1 人が完了
  • MUST_ALL: 担当者全員の完了が必要

注意

  • タスクの部分更新では、担当者が 2 人以上の場合にのみ指定できる。

Allowed values : ANY_ONE, MUST_ALL 
content string 

タスク内容

 
createdTime string 

登録日時 (YYYY-MM-DDThh:mm:ssTZD)


readOnly : true 
dueDate string 

期限 (YYYY-MM-DD)


nullable : true 
modifiedTime string 

更新日時 (YYYY-MM-DDThh:mm:ssTZD)


readOnly : true 
resourceLocation integer 

リソースロケーションコード


readOnly : true 
status string 

タスクの完了ステータス

  • DONE: 完了
  • TODO: 未完了

参考

  • 担当者を追加する場合には、常に TODO に設定する。
  • タスクの完了ステータスは、以下の API で変更する。
  • タスクの完了
  • タスクの完了取り消し
  • 自分のタスクの完了
  • 自分のタスクの完了取り消し

Allowed values : DONE, TODO 
taskId string 

タスク ID

 
title string 

件名

 

Assignee

PropertyTypeDescription
assigneeId string 

担当者 ID
削除されたアカウントは空白で表示される。


required 
assigneeName string 

担当者名


readOnly : true 
status string 

タスクの完了ステータス

  • DONE: 完了
  • TODO: 未完了

参考

  • 担当者を追加する場合には、常に TODO に設定する。
  • タスクの完了ステータスは、以下の API で変更する。
  • タスクの完了
  • タスクの完了取り消し
  • 自分のタスクの完了
  • 自分のタスクの完了取り消し

required
Allowed values : DONE, TODO 

Response Example

example

1{2  "assignees": [3    {4      "assigneeId": "userf7da-f82c-4284-13e7-030f3b4c754x",5      "assigneeName": "Susan Nielsen",6      "status": "TODO"7    },8    {9      "assigneeId": "userf7da-f82c-4284-13e7-030f3b4c756x",10      "assigneeName": "Assignee Name",11      "status": "TODO"12    }13  ],14  "assignorId": "userf7da-f82c-4284-13e7-030f3b4c756x",15  "assignorName": "Assignor Name",16  "completionCondition": "MUST_ALL",17  "content": "タスク内容",18  "createdTime": "2024-04-04T04:52:06.405Z",19  "dueDate": null,20  "modifiedTime": "2024-04-04T05:41:52.624Z",21  "resourceLocation": 14101,22  "status": "TODO",23  "taskId": "95e426f5-9c85-4d28-9c41-f22950398c9c",24  "title": "タスク"25}