Sign in
Project portfolio settings

Get a project portfolio setting

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

Returns the complete project portfolio setting record for a single project portfolio setting.

get/project_portfolio_settings/{project_portfolio_setting_gid}

Request

  • Base URL: https://app.asana.com/api/1.0
  • URL: https://app.asana.com/api/1.0/project_portfolio_settings/{project_portfolio_setting_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_portfolio_settings: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 portfolio setting.

Example response

{
  "data": {
    "gid": "12345",
    "resource_type": "project_portfolio_setting",
    "project": {
      "gid": "12345",
      "resource_type": "project",
      "name": "Stuff to buy",
      "resource_subtype": "default_project"
    },
    "portfolio": {
      "gid": "12345",
      "resource_type": "portfolio",
      "name": "Bug Portfolio",
      "resource_subtype": "default_portfolio"
    },
    "is_access_control_inherited": true,
    "created_at": "2012-02-22T02:06:58.147Z"
  }
}

Changes

No operation changes recorded.