Project templates

Get a project template

<b>Required scope: </b><code>project_templates:read</code>

Returns the complete project template record for a single project template.

get/project_templates/{project_template_gid}

Request

  • Base URL: https://app.asana.com/api/1.0
  • URL: https://app.asana.com/api/1.0/project_templates/{project_template_gid}
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.asana.com/-/oauth_authorize, token URL https://app.asana.com/-/oauth_token, scopes: project_templates:read)

Query parameters

opt_fieldsstring[]

This endpoint returns a resource which excludes some properties by default. To include those optional properties, set this query parameter to a comma-separated list of the properties you wish to include. Properties can include nested fields. To learn more, see the input/output options guide.

Response

Successfully retrieved the requested project template.

Example response

{
  "data": {
    "gid": "12345",
    "resource_type": "project_template",
    "name": "Packing list",
    "description": "These are things we need to pack for a trip.",
    "html_description": "<body>These are things we need to pack for a trip.</body>",
    "owner": {
      "gid": "12345",
      "resource_type": "user",
      "name": "Greg Sanchez"
    },
    "team": {
      "gid": "12345",
      "resource_type": "team",
      "name": "Marketing"
    },
    "requested_dates": [
      {
        "gid": "1",
        "name": "Start Date",
        "description": "Choose a start date for your project."
      }
    ],
    "color": "light-green",
    "requested_roles": [
      {
        "gid": "12345",
        "resource_type": "task",
        "name": "Designer"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.