Skip to content

Latest commit

 

History

History
162 lines (98 loc) · 3.78 KB

tasks.md

File metadata and controls

162 lines (98 loc) · 3.78 KB

TasksManager

List tasks on file

Retrieves a list of all the tasks for a file. This endpoint does not support pagination.

This operation is performed by calling function getFileTasks.

See the endpoint docs at API Reference.

client.getTasks().getFileTasks(file.getId())

Arguments

  • fileId String
    • The unique identifier that represents a file. The ID for any file can be determined by visiting a file in the web application and copying the ID from the URL. For example, for the URL https://*.app.box.com/files/123 the file_id is 123. Example: "12345"
  • headers GetFileTasksHeaders
    • Headers of getFileTasks method

Returns

This function returns a value of type Tasks.

Returns a list of tasks on a file.

If there are no tasks on this file an empty collection is returned instead.

Create task

Creates a single task on a file. This task is not assigned to any user and will need to be assigned separately.

This operation is performed by calling function createTask.

See the endpoint docs at API Reference.

client.getTasks().createTask(new CreateTaskRequestBody.Builder(new CreateTaskRequestBodyItemField.Builder().id(file.getId()).type(CreateTaskRequestBodyItemTypeField.FILE).build()).action(CreateTaskRequestBodyActionField.REVIEW).message("test message").dueAt(dateTime).completionRule(CreateTaskRequestBodyCompletionRuleField.ALL_ASSIGNEES).build())

Arguments

  • requestBody CreateTaskRequestBody
    • Request body of createTask method
  • headers CreateTaskHeaders
    • Headers of createTask method

Returns

This function returns a value of type Task.

Returns the newly created task.

Get task

Retrieves information about a specific task.

This operation is performed by calling function getTaskById.

See the endpoint docs at API Reference.

client.getTasks().getTaskById(task.getId())

Arguments

  • taskId String
    • The ID of the task. Example: "12345"
  • headers GetTaskByIdHeaders
    • Headers of getTaskById method

Returns

This function returns a value of type Task.

Returns a task object.

Update task

Updates a task. This can be used to update a task's configuration, or to update its completion state.

This operation is performed by calling function updateTaskById.

See the endpoint docs at API Reference.

client.getTasks().updateTaskById(task.getId(), new UpdateTaskByIdRequestBody.Builder().message("updated message").build())

Arguments

  • taskId String
    • The ID of the task. Example: "12345"
  • requestBody UpdateTaskByIdRequestBody
    • Request body of updateTaskById method
  • headers UpdateTaskByIdHeaders
    • Headers of updateTaskById method

Returns

This function returns a value of type Task.

Returns the updated task object.

Remove task

Removes a task from a file.

This operation is performed by calling function deleteTaskById.

See the endpoint docs at API Reference.

client.getTasks().deleteTaskById(task.getId())

Arguments

  • taskId String
    • The ID of the task. Example: "12345"
  • headers DeleteTaskByIdHeaders
    • Headers of deleteTaskById method

Returns

This function returns a value of type void.

Returns an empty response when the task was successfully deleted.