manage_project_task
Manage project tasks in Freshservice: create, update, retrieve, filter, delete, add notes, and link associations to streamline project workflows.
Instructions
Manage Freshservice Project Tasks (NewGen).
Tasks organize project work — epics, user stories, subtasks, etc.
Each task has a type, status, priority, assignee, and can be linked
to sprints, versions, and parent tasks.
Args:
action: One of 'create', 'update', 'get', 'list', 'filter',
'delete', 'get_task_types', 'get_task_type_fields',
'get_task_statuses', 'get_task_priorities',
'create_note', 'list_notes', 'update_note', 'delete_note',
'create_association', 'get_associations', 'delete_association'.
project_id: Project ID (required for all actions).
task_id: Task ID (required for get/update/delete and note/association ops).
title: Task title (create — MANDATORY).
description: Task description (HTML or plain text).
type_id: Task type ID — obtain via get_task_types (create — MANDATORY).
status_id: Task status ID — obtain via get_task_statuses.
priority_id: Task priority ID — obtain via get_task_priorities.
assignee_id: User ID to assign the task to.
reporter_id: User ID of the reporter (defaults to creator).
parent_id: Parent task/epic ID for subtasks.
planned_start_date: ISO datetime (yyyy-mm-ddThh:mm:ssZ).
planned_end_date: ISO datetime (yyyy-mm-ddThh:mm:ssZ).
planned_effort: Effort string, e.g. '1w 2d 3h 4m'.
story_points: Story points for the task.
sprint_id: Sprint ID — obtain via manage_project get_sprints.
version_id: Version ID — obtain via manage_project get_versions.
custom_fields: Custom fields dict.
note_id: Note ID (update_note / delete_note).
content: Note content — HTML (create_note / update_note).
module_name: Association module — 'tickets', 'problems',
'changes', or 'assets' (association operations).
ids: Entity IDs to associate (create_association).
association_id: Entity ID to dissociate (delete_association).
query: Filter query for 'filter' action. Format:
"priority_id:3 AND created_at:>'2025-01-01'"
filter: Predefined filter for 'list' — 'all', etc.
page/per_page: Pagination.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | No | ||
| page | No | ||
| query | No | ||
| title | No | ||
| action | Yes | ||
| filter | No | ||
| content | No | ||
| note_id | No | ||
| task_id | No | ||
| type_id | No | ||
| per_page | No | ||
| parent_id | No | ||
| sprint_id | No | ||
| status_id | No | ||
| project_id | No | ||
| version_id | No | ||
| assignee_id | No | ||
| description | No | ||
| module_name | No | ||
| priority_id | No | ||
| reporter_id | No | ||
| story_points | No | ||
| custom_fields | No | ||
| association_id | No | ||
| planned_effort | No | ||
| planned_end_date | No | ||
| planned_start_date | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |