Projects

Get projects a task is in

Changed on

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

Returns a compact representation of all of the projects the task is in.

get/tasks/{task_gid}/projects

Request

  • Base URL: https://app.asana.com/api/1.0
  • URL: https://app.asana.com/api/1.0/tasks/{task_gid}/projects
  • 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: projects: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 projects for the given task.

Example response

{
  "data": [
    {
      "gid": "12345",
      "resource_type": "project",
      "name": "Stuff to buy",
      "resource_subtype": "default_project"
    }
  ],
  "next_page": {
    "offset": "eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9",
    "path": "/tasks/12345/attachments?limit=2&offset=eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9",
    "uri": "https://app.asana.com/api/1.0/tasks/12345/attachments?limit=2&offset=eyJ0eXAiOJiKV1iQLCJhbGciOiJIUzI1NiJ9"
  }
}

Changes

  • 2aac685725ecRevision changes
    • info

      added the enum value custom_field_settings.parent.resource_subtype to the property items/ of the query request parameter opt_fields

    • info

      added the enum value custom_field_settings.project.resource_subtype to the property items/ of the query request parameter opt_fields

    • info

      added the enum value custom_type to the property items/ of the query request parameter opt_fields

    • info

      added the enum value custom_type.asana_created_type_identifier to the property items/ of the query request parameter opt_fields

    • info

      added the enum value custom_type.name to the property items/ of the query request parameter opt_fields

    • info

      added the enum value resource_subtype to the property items/ of the query request parameter opt_fields

    • info

      added the optional property // to the response with the status

  • ffff7e2b0075Revision changes
    • info

      added the new optional query request parameter include_inherited_projects to all path's operations