Task

Task objects represent tasks to be completed by reps.

📄️ Get task

Retrieves a single task by its ID. Requires the `task:list` permission for the task owner or the user who assigned it. Use `/task/list` or `/task/management` instead to find tasks.

📄️ List tasks

Lists tasks assigned to a single user, sorted by priority (highest first), within an optional date range. Omit `ownerId` to use the authenticated user; `endDate` defaults to now. Requires the `task:list` permission for the owner. Use `/task/management` instead to search tasks across multiple owners, teams, programs, or statuses.

📄️ Update task

Updates one or more tasks, identified by `taskId` and/or `taskIds`. Only the fields you provide are changed. Requires the `task:update` or `task:manage` permission for the task owners.

📄️ Manage tasks

Searches tasks across owners, assigners, teams, programs, statuses, and other criteria for administrative task management. Requires the `task:manage` permission for the company or the requested owners, assigners, and teams. Use `/task/list` instead to get a single user's own tasks.

📄️ Remove task

Removes one or more tasks, identified by `taskId` and/or `taskIds`. By default tasks are archived; set `archive` to `false` to delete them permanently. Requires the `task:update` permission for the task owners.