Methods for Working with Tasks (item)

If you are developing integrations for Bitrix24 using AI tools (Codex, Claude Code, Cursor), connect to the MCP server so that the assistant can utilize the official REST documentation.

DEPRECATED

The development of methods task.item.* has been halted.
Please refer to the section Current Task Methods (tasks.task.*).

Scope: task

Who can execute the method: any user

Allowed Fields

Name	Description	Read	Write	Sort	Filter
TITLE	Task name	+	+	+	+
DESCRIPTION	Task description	+	+
DEADLINE	Deadline	+	+	+
START_DATE_PLAN	Planned start date	+	+	+	+
END_DATE_PLAN	Planned end date	+	+		+
PRIORITY	Priority	+	+	+	+
ACCOMPLICES	Participants (user identifiers)	+	+
ACCOMPLICE	Participants (field used for filtering)				+
AUDITORS	Observers (user identifiers)	+	+
AUDITOR	Observers (field used for filtering)				+
TAGS	Tags (when added — simply an array of tags in text form). `CTasks::GetList()` does not return tag fields. `CTaskItem::getInstance()->getTags()` returns an array of tag names	+	+
TAG	Tags (field used for filtering)				+
ALLOW_CHANGE_DEADLINE	Flag "Allow the executor (responsible) to change the deadline"	+	+	+
TASK_CONTROL	Flag "Accept work after task completion"	+	+
PARENT_ID	Identifier of the parent task	+	+		+
DEPENDS_ON	Identifier of the previous task	+	+		+
GROUP_ID	Identifier of the working group	+	+	+	+
RESPONSIBLE_ID	Identifier of the executor	+	+	+	+
TIME_ESTIMATE	Planned labor costs	+	+	+	+
ID	Task identifier. Unique within the database	+		+	+
CREATED_BY	Identifier of the Creator	+	+	+	+
DESCRIPTION_IN_BBCODE	Is the task description stored in BB codes	+
DECLINE_REASON	Reason for task rejection	+	+
STATUS	Task status	+	+	+	+
RESPONSIBLE_NAME	Executor's first name	+			+
RESPONSIBLE_LAST_NAME	Executor's last name	+
RESPONSIBLE_SECOND_NAME	Executor's middle name	+
DATE_START	Date when the task execution started	+		+	+
DURATION_FACT	Time spent on the task in minutes	+
DURATION_PLAN	Planned duration in hours or days	+	+
DURATION_TYPE	Unit type for planned duration: days, hours, or minutes	+	+
CREATED_BY_NAME	Creator's first name	+
CREATED_BY_LAST_NAME	Creator's last name	+
CREATED_BY_SECOND_NAME	Creator's middle name	+
CREATED_DATE	Task creation date	+	+	+	+
CHANGED_BY	User who last modified the task (user identifier)	+	+		+
CHANGED_DATE	Date of the last task modification	+	+	+	+
STATUS_CHANGED_BY	User who changed the task status (user identifier)	+	+		+
STATUS_CHANGED_DATE	Date of status change	+	+
CLOSED_BY	Who completed the task	+
CLOSED_DATE	Date of task completion	+		+	+
GUID	Globally unique identifier	+			+
MARK	Task rating. Possible values: `P` (positive) and `N` (negative)	+	+	+	+
VIEWED_DATE	Date of the last view of the task in the public interface by the current user	+
TIME_SPENT_IN_LOGS	Time spent on the task in seconds	+
FAVORITE	Presence in Favorites for the current user	+		+	+
ALLOW_TIME_TRACKING	Is time tracking enabled for the task	+	+	+	+
ADD_IN_REPORT	Is the task included in the performance report	+	+		+
FORUM_ID	Identifier of the forum where comments to the task are stored	+
FORUM_TOPIC_ID	Identifier of the forum topic where comments to the task are stored	+			+
COMMENTS_COUNT	Number of comments on the task	+
SITE_ID	Identifier of the site. By default, this field records the identifier of the site where the task is created	+	+		+
SUBORDINATE	Is any of the task participants a subordinate of the current user	+
FORKED_BY_TEMPLATE_ID	Identifier of the template based on which the task was automatically created. For some old tasks, this may not be set	+
MULTITASK	Was the task created for multiple executors	+
ONLY_ROOT_TASKS	Field that allows selecting only those tasks that either have no parent task or have one, but we do not have access to that parent task				+
MATCH_WORK_TIME	Should the execution dates and deadline always be set during working hours	+	+	+	+

To obtain the tags of a specific task, you need to pass the parameter /rest/task.item.gettags.xml?TASK_ID=3&auth=18tci5kga6v12g8okzm5r26sv0n9is84. The request can be either ID or TASK_ID. It is essential that this parameter is first. The response will return {"result":["TAG1","TAG2","ETC..."]}.

Overview of Methods

View task change history

Method	Description
task.item.add	Creates a new task
task.item.delete	Deletes a task
task.item.getdata	Returns an array of task data
task.item.getmanifest	Returns a list of `task.item.*` methods with their descriptions
task.item.list	Returns a list of tasks
task.item.update	Updates task data
task.item.getdescription	Returns the task description
task.item.getfiles	Returns an array with links to files attached to the task
task.item.getdependson	Returns an array with identifiers of tasks that the task depends on
task.item.getallowedactions	Returns an array of 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
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 (awaiting executor control)"
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"
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
task.logitem.list	Returns the history of task changes

Methods for Working with Tasks (item)

Allowed FieldsAllowed Fields

Overview of MethodsOverview of Methods

Allowed Fields

Overview of Methods