Sample - Asana API
POST/project_templates/{project_template_gid}/instantiateProject

Instantiate a project from a project template

Creates an asynchronous job that instantiates a new project from a project template. Provide the project name and, when the template includes date variables, supply the corresponding requested_dates; use requested_roles to map template roles to users. Poll the returned job resource to monitor the instantiation process.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 parameter · 1 body field
opt_fieldsarray<string>optional
Comma-separated fields to include in the job response, such as `new_project`, `new_project.name`, `new_portfolio`, or `new_graph_export`; nested fields are supported.

Optional project-instantiation inputs in the data block; name is required.

dataobjectoptional
The inputs for creating the project from the template.

6 status codes
201Returns a job object representing the asynchronous project-instantiation process, including its identifier, status, and resulting resources when available.
dataobjectoptional
A *job* is an object representing a process that handles asynchronous work.
400Returned when `name` is missing or a request parameter or body value is malformed.
errorsarray<object>optional
401Returned when a valid authentication token was not provided with the request.
errorsarray<object>optional
403Returned when the authenticated user does not have the required scope or access to the project template.
errorsarray<object>optional
404Returned when the project template does not exist or the requested action is not recognized.
errorsarray<object>optional
500Returned when a server-side problem prevents the job from being created.
errorsarray<object>optional

Error handling

A 400 is returned when name is missing or another request value is malformed; provide requested_dates when the template includes date variables. A 401 is returned when you do not provide a valid authentication token, and a 403 is returned when the authenticated user lacks the required projects:write scope or access to the template. A 404 is returned when the template does not exist or the action is not recognized; a 500 indicates a server-side failure.