Portfolio memberships

A portfolio membership determines if a user is a member of a portfolio.


DeprecatedPortfolioMembershipCompact

PropertyTypeDescription
gidstringGlobally unique identifier of the resource, as a string.
resource_typestringThe base type of this resource.
portfolioobjectA portfolio gives a high-level overview of the status of multiple initiatives in Asana. Portfolios provide a dashboard overview of the state of multiple projects, including a progress report and the most recent project status update. Portfolios have some restrictions on size. Each portfolio has a max of 1500 items and, like projects, a max of 20 custom fields.
portfolio.gidstringGlobally unique identifier of the resource, as a string.
portfolio.resource_typestringThe base type of this resource.
portfolio.namestringThe name of the portfolio.
userobject

Full object requires scope: users:read

A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.
user.gidstringGlobally unique identifier of the resource, as a string.
user.resource_typestringThe base type of this resource.
user.namestringRead-only except when same user as requester. The user's name.
access_levelstringWhether the member has admin, editor, or viewer access to the portfolio. Portfolios do not support commenter access yet.
Click to show all enum values
  • admin
  • editor
  • viewer

Example JSON for DeprecatedPortfolioMembershipCompact:

{
  "gid": "12345",
  "resource_type": "portfolio_membership",
  "portfolio": {
    "gid": "12345",
    "resource_type": "portfolio",
    "name": "Bug Portfolio"
  },
  "user": {
    "gid": "12345",
    "resource_type": "user",
    "name": "Greg Sanchez"
  },
  "access_level": "admin"
}

DeprecatedPortfolioMembership

PropertyTypeDescription
gidstringGlobally unique identifier of the resource, as a string.
resource_typestringThe base type of this resource.
portfolioobjectA portfolio gives a high-level overview of the status of multiple initiatives in Asana. Portfolios provide a dashboard overview of the state of multiple projects, including a progress report and the most recent project status update. Portfolios have some restrictions on size. Each portfolio has a max of 1500 items and, like projects, a max of 20 custom fields.
portfolio.gidstringGlobally unique identifier of the resource, as a string.
portfolio.resource_typestringThe base type of this resource.
portfolio.namestringThe name of the portfolio.
userobject

Full object requires scope: users:read

A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.
user.gidstringGlobally unique identifier of the resource, as a string.
user.resource_typestringThe base type of this resource.
user.namestringRead-only except when same user as requester. The user's name.
access_levelstringWhether the member has admin, editor, or viewer access to the portfolio. Portfolios do not support commenter access yet.
Click to show all enum values
  • admin
  • editor
  • viewer

Example JSON for DeprecatedPortfolioMembership:

{
  "gid": "12345",
  "resource_type": "portfolio_membership",
  "portfolio": {
    "gid": "12345",
    "resource_type": "portfolio",
    "name": "Bug Portfolio"
  },
  "user": {
    "gid": "12345",
    "resource_type": "user",
    "name": "Greg Sanchez"
  },
  "access_level": "admin"
}
Asana Home
Asana helps you manage projects, focus on what's important, and organize work in one place for seamless collaboration.
© 2023 Asana, Inc.