Task API로 할 일, 카테고리 등을 관리할 수 있다.
Task API를 호출하려면 구성원 계정으로 인증하여 얻은 Access Token이 필요하다. 서비스 계정으로 인증하여 얻은 Access Token으로는 API를 호출할 수 없다.
API scope는 task, task.read이다.
할 일의 조회·생성·수정은 아래 API를 이용한다. 내 할 일의 카테고리를 이동할 수도 있다.
| HTTP Request | Description |
|---|---|
| POST /users/{userId}/tasks | 내 할 일 생성 |
| GET /users/{userId}/tasks | 내 할 일 목록 조회 |
| GET /tasks/{taskId} | 할 일 상세 조회 |
| PATCH /tasks/{taskId} | 할 일 부분 수정 |
| DELETE /tasks/{taskId} | 할 일 삭제 |
| POST /users/{userId}/tasks/{taskId}/move | 할 일의 개인 카테고리 이동 |
다음 API로 할 일을 완료 및 미완료 처리할 수 있다.
| HTTP Request | Description |
|---|---|
| POST /tasks/{taskId}/complete | 할 일 완료 처리 |
| POST /tasks/{taskId}/incomplete | 할 일 미완료 처리 |
| POST /tasks/{taskId}/assignees/{userId}/complete | 담당자의 할 일 완료 처리 |
| POST /tasks/{taskId}/assignees/{userId}/incomplete | 담당자의 할 일 미완료 처리 |
할 일 카테고리 관리는 아래 API를 이용한다.
| HTTP Request | Description |
|---|---|
| POST /users/{userId}/task-categories | 할 일 개인 카테고리 생성 |
| GET /users/{userId}/task-categories | 할 일 개인 카테고리 목록 조회 |
| GET /users/{userId}/task-categories/{categoryId} | 할 일 개인 카테고리 조회 |
| PATCH /users/{userId}/task-categories/{categoryId} | 할 일 개인 카테고리 부분 수정 |
| DELETE /users/{userId}/task-categories/{categoryId} | 할 일 개인 카테고리 삭제 |