Asana

Get memberships from a portfolio

GET

/portfolios/{portfolio_gid}/portfolio_memberships

Portfolio Memberships

Returns the compact portfolio membership records for the portfolio.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://app.asana.com/api/1.0/portfolios//portfolio_memberships'

Response Example

200 - Example 1

{
  "data": [
    {
      "gid": "12345",
      "resource_type": "task",
      "portfolio": {
        "gid": "12345",
        "resource_type": "task",
        "name": "Bug Portfolio"
      },
      "user": {
        "gid": "12345",
        "resource_type": "task",
        "name": "Greg Sanchez"
      }
    }
  ]
}

Request

Path Params

portfolio_gid

string

required

Responses

🟢200Successfully retrieved the requested portfolio's memberships.

application/json

Body

data

array[object (PortfolioMembershipCompact) {4}]

optional

gid

string

read-onlyoptional

Globally unique identifier of the resource, as a string.

Example:

12345

resource_type

string

read-onlyoptional

The base type of this resource.

Example:

task

portfolio

object

PortfolioCompact

optional

A 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 250 items and, like projects, a max of 20 custom fields.

user

object

UserCompact

optional

A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.

🟠400400

🟠401401

🟠403403

🟠404404

🔴500500

Modified at 2022-09-13 02:00:31

Get a portfolio membership

Get multiple portfolios