Deprecated task.item.* Methods: Overview of Methods

Scope: task

Who can execute the method: any user

The task.item.* methods are kept only to support legacy integrations. For new development, use the tasks.task.* methods, which work with the current task card.

Quick navigation: all methods

How to Choose a VersionHow to Choose a Version

If you are creating a new integration, use the tasks.task.* methods. They support current task scenarios, comments, files, results, and statuses.

If an integration already uses task.item.*, keep these methods only to maintain existing code. When you update the integration, plan the migration to tasks.task.*.

Relationship with Other ObjectsRelationship with Other Objects

Task. The task.item.* methods manage a task by its identifier. You can retrieve current task data using task.item.getdata or through the new tasks.task.get branch.

Files. Files are attached to a task using the deprecated task.item.addfile and task.item.deletefile methods. In the new branch, use the tasks.task.files.attach method.

Change History. Task change history is returned by the task.logitem.list method.

Overview of MethodsOverview of Methods

Basic MethodsBasic Methods

Method	Description
task.item.add	Creates a task
task.item.update	Updates a task
task.item.getdata	Returns task data
task.item.list	Returns a list of tasks
task.item.delete	Deletes a task
task.item.getdescription	Returns the task description
task.item.getfiles	Returns links to task files
task.item.getdependson	Returns identifiers of tasks that the task depends on
task.logitem.list	Returns the task change history

Reference MethodsReference Methods

Method	Description
task.item.getmanifest	Returns a list of task.item.* methods with their descriptions
task.item.getallowedactions	Returns identifiers of allowed actions on the task
task.item.getallowedtaskactionsasstrings	Returns a list of allowed actions on the task
task.item.isactionallowed	Checks if the action is allowed

Status ManagementStatus Management

Method	Description
task.item.delegate	Delegates the task to a new user
task.item.startexecution	Changes the task status to "in progress"
task.item.defer	Changes the task status to "deferred"
task.item.complete	Changes the task status to "completed" or "conditionally completed"
task.item.renew	Changes the task status to "not executed"
task.item.approve	Changes a task awaiting control to "completed"
task.item.disapprove	Changes a task awaiting control to "not executed"

Favorites and FilesFavorites and Files

Method	Description
task.item.addtofavourite	Adds the task to Favorites
task.item.deletefromfavorite	Removes the task from Favorites
task.item.addfile	Uploads a file to the task
task.item.deletefile	Removes the file attachment from the task