Skip to content

Asana: Task templates schemas

10 Asana schemas with complete fields and constraints.

← Task templates operations · All schemas

Get a task template — response body — data

FieldTypePresenceDescription and constraints
$objectRoot
dataModelRequired within parentExpand Get a task template — response body — data data — sdk__Task Template Response

Referenced models: Get a task template — response body — data data — sdk__Task Template Response

Get a task template — response body — data / data / created_at, created_by, name, project, template / template / task_resource_subtype: default task, milestone task, approval task

FieldTypePresenceDescription and constraints
$JSONRoot
$ (allOf 1)ModelAll variants applyExpand Get a task template — response body — data / data / created_at, created_by, name, project, template / template / task_resource_subtype: default task, milestone task, approval task task resource subtype: default task, milestone task, approval task
$ (allOf 2)objectAll variants apply
$ (allOf 2).descriptionstringOptionalDescription of the task that will be created from this template.
$ (allOf 2).html_descriptionstringOptionalHTML description of the task that will be created from this template. See [rich text](/docs/rich-text#reading-rich-text).
$ (allOf 2).membershipsarrayOptionalArray of projects that the task created from this template will be added to
$ (allOf 2).memberships[]ModelEach itemExpand Search projects in a workspace — response body — data data item
$ (allOf 2).relative_start_onJSONOptional
$ (allOf 2).relative_start_on (anyOf 1)JSONAlternative
$ (allOf 2).relative_start_on (anyOf 1) (anyOf 1)integerAlternativeThe number of days after the task has been instantiated on which that the task will start
$ (allOf 2).relative_start_on (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (allOf 2).relative_start_on (anyOf 2)nullAlternative
$ (allOf 2).relative_due_onJSONOptional
$ (allOf 2).relative_due_on (anyOf 1)JSONAlternative
$ (allOf 2).relative_due_on (anyOf 1) (anyOf 1)integerAlternativeThe number of days after the task has been instantiated on which that the task will be due
$ (allOf 2).relative_due_on (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
$ (allOf 2).relative_due_on (anyOf 2)nullAlternative
$ (allOf 2).due_timeJSONOptional
$ (allOf 2).due_time (anyOf 1)stringAlternativeThe time of day that the task will be due
$ (allOf 2).due_time (anyOf 2)nullAlternative
$ (allOf 2).dependenciesarrayOptionalArray of task templates that the task created from this template will depend on
$ (allOf 2).dependencies[]ModelEach itemExpand Get a task template — response body — data / data / created_at, created_by, name, project, template / template / task_resource_subtype: default task, milestone task, approval task task resource subtype: default task, milestone task, approval task
$ (allOf 2).dependentsarrayOptionalArray of task templates that will depend on the task created from this template
$ (allOf 2).dependents[]ModelEach itemExpand Get a task template — response body — data / data / created_at, created_by, name, project, template / template / task_resource_subtype: default task, milestone task, approval task task resource subtype: default task, milestone task, approval task
$ (allOf 2).followersarrayOptionalArray of users that will be added as followers to the task created from this template
$ (allOf 2).followers[]ModelEach itemExpand Get users in a team — response body — data data item
$ (allOf 2).attachmentsarrayOptionalArray of attachments that will be added to the task created from this template
$ (allOf 2).attachments[]ModelEach itemExpand Get attachments from an object — response body — data, next page data item
$ (allOf 2).subtasksarrayOptionalArray of subtasks that will be added to the task created from this template
$ (allOf 2).subtasks[]ModelEach itemExpand Get a task template — response body — data / data / created_at, created_by, name, project, template / template / task_resource_subtype: default task, milestone task, approval task task resource subtype: default task, milestone task, approval task
$ (allOf 2).custom_fieldsarrayOptionalArray of custom fields that will be added to the task created from this template
$ (allOf 2).custom_fields[]ModelEach itemExpand Get a membership — response body — data / data / access_level: admin, editor, user parent

Referenced models: Get attachments from an object — response body — data, next page data item, Get a membership — response body — data / data / access_level: admin, editor, user parent, Search projects in a workspace — response body — data data item, Get a task template — response body — data / data / created_at, created_by, name, project, template / template / task_resource_subtype: default task, milestone task, approval task task resource subtype: default task, milestone task, approval task, Get users in a team — response body — data data item

Get a task template — response body — data / data / created_at, created_by, name, project, template / template / task_resource_subtype: default task, milestone task, approval task task resource subtype: default task, milestone task, approval task

FieldTypePresenceDescription and constraints
$objectRoot
namestringOptionalName of the task that will be created from this template.
task_resource_subtypestringOptionalThe subtype of the task that will be created from this template.
Known values: default_task, milestone_task, approval_task

Get a task template — response body — data / data / template / task_resource_subtype: default task, milestone task, approval task attachments item

FieldTypePresenceDescription and constraints
$objectRootA generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.
An *attachment* object represents any file attached to a task in Asana, whether it's an uploaded file or one associated via a third-party service such as Dropbox or Google Drive.
gidstringOptionalGlobally unique identifier of the resource, as a string.
Read only: true
resource_typestringOptionalThe base type of this resource.
Read only: true
namestringOptionalThe name of the file.
Read only: true
resource_subtypestringOptionalThe service hosting the attachment. Valid values are `asana`, `dropbox`, `gdrive`, `onedrive`, `box`, `vimeo`, and `external`.

Get a task template — response body — data data gid, name, resource type

FieldTypePresenceDescription and constraints
$JSONRoot
$ (allOf 1)ModelAll variants applyExpand Get multiple task templates — response body — data, next page data item

Referenced models: Get multiple task templates — response body — data, next page data item

Get a task template — response body — data data — Task Template Response

FieldTypePresenceDescription and constraints
$JSONRoot
$ (allOf 1)ModelAll variants applyExpand Get a task template — response body — data data gid, name, resource type
$ (allOf 2)objectAll variants apply
$ (allOf 2).namestringOptionalName of the task template.
$ (allOf 2).projectJSONOptional
$ (allOf 2).project (anyOf 1)JSONAlternativeThe project that this task template belongs to.
$ (allOf 2).project (anyOf 1) (allOf 1)ModelAll variants applyExpand Search projects in a workspace — response body — data data item
$ (allOf 2).project (anyOf 2)nullAlternative
$ (allOf 2).templateJSONOptionalThe configuration for the task that will be created from this template.
$ (allOf 2).template (allOf 1)ModelAll variants applyExpand Get a task template — response body — data / data / created_at, created_by, name, project, template / template / task_resource_subtype: default task, milestone task, approval task
$ (allOf 2).created_byJSONOptionalThe user who created this task template.
$ (allOf 2).created_by (allOf 1)ModelAll variants applyExpand Get users in a team — response body — data data item
$ (allOf 2).created_atstringOptionalThe time at which this task template was created.
Format: date-time

Referenced models: Search projects in a workspace — response body — data data item, Get a task template — response body — data data gid, name, resource type, Get a task template — response body — data / data / created_at, created_by, name, project, template / template / task_resource_subtype: default task, milestone task, approval task, Get users in a team — response body — data data item

Get a task template — response body — data data — sdk__Task Template Response

FieldTypePresenceDescription and constraints
$objectRootA generic Asana Resource, containing a globally unique identifier.A generic Asana Resource, containing a globally unique identifier.
A *task template* is an object that allows new tasks to be created with a predefined setup.
gidstringOptionalGlobally unique identifier of the resource, as a string.
Read only: true
resource_typestringOptionalThe base type of this resource.
Read only: true
namestringOptionalName of the task template.
projectJSONOptional
project (anyOf 1)JSONAlternativeThe project that this task template belongs to.
project (anyOf 1) (allOf 1)ModelAll variants applyExpand Get a rate — response body — data data parent
project (anyOf 2)nullAlternative
templateJSONOptionalThe configuration for the task that will be created from this template.
template (allOf 1)objectAll variants apply
template (allOf 1).namestringOptionalName of the task that will be created from this template.
template (allOf 1).task_resource_subtypestringOptionalThe subtype of the task that will be created from this template.
Known values: default_task, milestone_task, approval_task
template (allOf 1).descriptionstringOptionalDescription of the task that will be created from this template.
template (allOf 1).html_descriptionstringOptionalHTML description of the task that will be created from this template. See [rich text](/docs/rich-text#reading-rich-text).
template (allOf 1).membershipsarrayOptionalArray of projects that the task created from this template will be added to
template (allOf 1).memberships[]ModelEach itemExpand Get a rate — response body — data data parent
template (allOf 1).relative_start_onJSONOptional
template (allOf 1).relative_start_on (anyOf 1)JSONAlternative
template (allOf 1).relative_start_on (anyOf 1) (anyOf 1)integerAlternativeThe number of days after the task has been instantiated on which that the task will start
template (allOf 1).relative_start_on (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
template (allOf 1).relative_start_on (anyOf 2)nullAlternative
template (allOf 1).relative_due_onJSONOptional
template (allOf 1).relative_due_on (anyOf 1)JSONAlternative
template (allOf 1).relative_due_on (anyOf 1) (anyOf 1)integerAlternativeThe number of days after the task has been instantiated on which that the task will be due
template (allOf 1).relative_due_on (anyOf 1) (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
template (allOf 1).relative_due_on (anyOf 2)nullAlternative
template (allOf 1).due_timeJSONOptional
template (allOf 1).due_time (anyOf 1)stringAlternativeThe time of day that the task will be due
template (allOf 1).due_time (anyOf 2)nullAlternative
template (allOf 1).dependenciesarrayOptionalArray of task templates that the task created from this template will depend on
template (allOf 1).dependencies[]objectEach item
template (allOf 1).dependencies[].namestringOptionalName of the task that will be created from this template.
template (allOf 1).dependencies[].task_resource_subtypestringOptionalThe subtype of the task that will be created from this template.
Known values: default_task, milestone_task, approval_task
template (allOf 1).dependentsarrayOptionalArray of task templates that will depend on the task created from this template
template (allOf 1).dependents[]objectEach item
template (allOf 1).dependents[].namestringOptionalName of the task that will be created from this template.
template (allOf 1).dependents[].task_resource_subtypestringOptionalThe subtype of the task that will be created from this template.
Known values: default_task, milestone_task, approval_task
template (allOf 1).followersarrayOptionalArray of users that will be added as followers to the task created from this template
template (allOf 1).followers[]ModelEach itemExpand Get an OOO entry — response body — data data user
template (allOf 1).attachmentsarrayOptionalArray of attachments that will be added to the task created from this template
template (allOf 1).attachments[]ModelEach itemExpand Get a task template — response body — data / data / template / task_resource_subtype: default task, milestone task, approval task attachments item
template (allOf 1).subtasksarrayOptionalArray of subtasks that will be added to the task created from this template
template (allOf 1).subtasks[]objectEach item
template (allOf 1).subtasks[].namestringOptionalName of the task that will be created from this template.
template (allOf 1).subtasks[].task_resource_subtypestringOptionalThe subtype of the task that will be created from this template.
Known values: default_task, milestone_task, approval_task
template (allOf 1).custom_fieldsarrayOptionalArray of custom fields that will be added to the task created from this template
template (allOf 1).custom_fields[]ModelEach itemExpand Get a goal — response body — data data custom fields item
created_byJSONOptionalThe user who created this task template.
created_by (allOf 1)ModelAll variants applyExpand Get an OOO entry — response body — data data user
created_atstringOptionalThe time at which this task template was created.
Format: date-time

Referenced models: Get a task template — response body — data / data / template / task_resource_subtype: default task, milestone task, approval task attachments item, Get an OOO entry — response body — data data user, Get a goal — response body — data data custom fields item, Get a rate — response body — data data parent

Get multiple task templates — response body — data, next page

FieldTypePresenceDescription and constraints
$objectRoot
dataarrayRequired within parent
data[]ModelEach itemExpand Get a task template — response body — data data — sdk__Task Template Response
next_pageModelOptionalExpand Get goals — response body — data, next page next page

Referenced models: Get goals — response body — data, next page next page, Get a task template — response body — data data — sdk__Task Template Response

Get multiple task templates — response body — data, next page data item

FieldTypePresenceDescription and constraints
$objectRootA *task template* is an object that allows new tasks to be created with a predefined setup.
gidstringOptionalGlobally unique identifier of the resource, as a string.
Read only: true
resource_typestringOptionalThe base type of this resource.
Read only: true
namestringOptionalName of the task template.

Instantiate a task from a task template — request body — body data

FieldTypePresenceDescription and constraints
$objectRoot
namestringOptionalThe name of the new task. If not provided, the name of the task template will be used.

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.