Hi all, we have a new addition to portfolios in the API: portfolio memberships! Now, you can see all the members on a portfolio, see what portfolios you’re a member of, and add or remove members on portfolios. The new portfolio_membership
resource contains two fields—one for the portfolio and one for the user—and you can read, create, and delete them though the following endpoints:
GET /portfolios/<portfolio>/portfolio_memberships
returns all the members of a given portfolioGET /portfolio_memberships
- With query parameters for
user
andworkspace
, returns all of that user’s portfolio memberships in that workspace - With query parameters for
portfolio
anduser
, returns the specific portfolio membership for that pair, if it exists.
- With query parameters for
GET /portfolio_memberships/<portfolio_membership>
returns a specific membership by GID.POST /portfolios/<portfolio>/addMembers
adds a set of users as members to a portfolioPOST /portfolios/<portfolio>/removeMembers
removes a set of users as members to a portfolio
You’ll find the full reference for these endpoints in the docs for portfolio memberships and portfolios. Enjoy!