absenceRegions11

absences5

accounts2

agentFiles2

agentRuntime10

agentSchedules10

agentSkills20

agentThreadFiles2

agentThreads7

apiUsers5

assignedTasks8

autopilot6

checklistItems16

clientApplications11

companies11

companyFiles16

companyTags6

customAgents16

customFields23

dashboards1

documentComments8

documentFiles15

documents23

documentSpaces11

files2

fileUpload2

filters20

images24

invitations3

permissions3

privateTasks10

projectActivities1

projectAutomations13

projectComments7

projectFiles18

projectMembers2

projectMilestones6

projectMilestoneTemplates5

projectRoles8

projects13

projectStatuses7

projectTags6

projectTasks6

projectTemplateAutomations12

projectTemplateFiles17

projectTemplates14

projectTemplateTags6

projectTypes7

retainers5

roles17

search1

sharedFiles2

taskActivities1

taskBundles29

taskComments7

taskDependencies4

taskDependencyTemplates5

taskFiles17

taskLists13

tasks21

taskSchedules6

taskStatuses5

taskTags9

taskTemplateFiles17

taskTemplates7

taskTemplateTags6

teams9

temporaryFiles6

timeBookings10

timeEntries18

timeReports1

timeTracking8

timeTrackingSettings1

typeOfWork7

userCapacities2

userFiles17

users15

userTags6

webhooks8

workflowAutomations12

workflows21

workload1

workspaceAbsences4

workspaceFiles17

workspaces3

taskTemplates

Updates the task template for the task bundle.

Changed on Oct 13, 2026

Updates the task template for the task bundle. The updated task template is stored in the bundle.

<Check title="Required Permissions" icon="key">The user must be an admin or have task-manage-config:write permissions.</Check>

put/taskbundles/{taskBundleId}/tasktemplates/{taskTemplateId}

Request

Base URL: https://api.awork.com/api/v1
URL: https://api.awork.com/api/v1/taskbundles/{taskBundleId}/tasktemplates/{taskTemplateId}
Auth: HTTP bearer

Path parameters

taskBundleIdstring uuid required

The id of the task bundle.

taskTemplateIdstring uuid required

The id of the task template.

Request body

namestring nullable

The name of the task created from this template.

descriptionstring nullable

The description of the task created from this template.

isPrioboolean

Whether the task created from this template will be marked as priority.

plannedDurationinteger

The expected planned workload of the task created from this template, in seconds.

relativeStartOninteger nullable

The relative start date and time of the task created from this template, in seconds, from the moment of creating the task.

relativeDueOninteger nullable

The relative due date and time of the task created from this template, in seconds, from the moment of creating the task.

typeOfWorkIdstring uuid

The id of the type of work of this task.

assignedRoleIdstring uuid nullable

The id of the assigned role of this task.

parentIdstring uuid nullable

The id of the parent task template if the task template is a subtask.

subtaskOrdernumber double nullable

The order of the subtask template relative to its parent task template.

laneOrderinteger nullable

The lane order defines the vertical position in the planner.

deriveDatesFromSubtasksboolean nullable

When true, if the task is a parent task, the StartOn and DueOn will be automatically adjusted to the start and due date of the subtasks.

Response

namestring nullable

The name of the task created from this template.

descriptionstring nullable

The description of the task created from this template.

isPrioboolean

Whether the task created from this template will be marked as priority.

plannedDurationinteger

The expected planned workload of the task created from this template, in seconds.

relativeStartOninteger nullable

The relative start date and time of the task created from this template, in seconds, from the moment of creating the task.

relativeDueOninteger nullable

The relative due date and time of the task created from this template, in seconds, from the moment of creating the task.

typeOfWorkIdstring uuid

The id of the type of work of this task.

assignedRoleIdstring uuid nullable

The id of the assigned role of this task.

parentIdstring uuid nullable

The id of the parent task template if the task template is a subtask.

subtaskOrdernumber double nullable

The order of the subtask template relative to its parent task template.

laneOrderinteger nullable

The lane order defines the vertical position in the planner.

deriveDatesFromSubtasksboolean nullable

When true, if the task is a parent task, the StartOn and DueOn will be automatically adjusted to the start and due date of the subtasks.

idstring uuid

The Id of the task template.

assigneeIdsstring[] nullable

The list of assigned users to that task template.

createdOnstring date-time

The date this task was created.

createdBystring uuid

The id of the user who created this task.

updatedOnstring date-time

The date this task was last modified.

updatedBystring uuid

The id of the user who last modified this task.

ordernumber double nullable

For internal purposes.

hasAttachmentsboolean

If the task template has attachments.

isRecurringboolean

If the task is a recurrency template, the flag is true.

Changes

Oct 13, 2026ab257be657b1 Revision changes
- info
  added the new optional request property
- info
  added the optional property to the response with the status
Sep 17, 20261556e0487867 Revision changes
- warning
  deleted the header request parameter Authorization
- info
  the endpoint scheme security oauth2 was added to the API

Operation history (3 revisions)