Skip to main content
Server path: /asana-portfolios | Type: Application | PCID required: Yes

Tools


asana_portfolios_add_custom_field_setting_for_portfolio

Add a custom field to a portfolio Parameters:
ParameterTypeRequiredDefaultDescription
portfolio_gidstringYesGlobally unique identifier for the portfolio.
opt_prettybooleanNoProvides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
dataobjectNoThe data value

asana_portfolios_add_item_for_portfolio

Add a portfolio item Parameters:
ParameterTypeRequiredDefaultDescription
portfolio_gidstringYesGlobally unique identifier for the portfolio.
opt_prettybooleanNoProvides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
dataobjectNoThe data value

asana_portfolios_add_members_for_portfolio

Add users to a portfolio Parameters:
ParameterTypeRequiredDefaultDescription
portfolio_gidstringYesGlobally unique identifier for the portfolio.
opt_prettybooleanNoProvides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
opt_fieldsstring[]NoThis 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.
dataobjectNoThe data value

asana_portfolios_create_portfolio

Create a portfolio Parameters:
ParameterTypeRequiredDefaultDescription
opt_prettybooleanNoProvides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
opt_fieldsstring[]NoThis 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.
dataobjectNoThe data value

asana_portfolios_delete_portfolio

Delete a portfolio Parameters:
ParameterTypeRequiredDefaultDescription
portfolio_gidstringYesGlobally unique identifier for the portfolio.
opt_prettybooleanNoProvides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.

asana_portfolios_duplicate_portfolio

Duplicate a portfolio Parameters:
ParameterTypeRequiredDefaultDescription
portfolio_gidstringYesGlobally unique identifier for the portfolio.
opt_prettybooleanNoProvides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
opt_fieldsstring[]NoThis 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.
dataobjectNoThe data value

asana_portfolios_get_items_for_portfolio

Get portfolio items Parameters:
ParameterTypeRequiredDefaultDescription
portfolio_gidstringYesGlobally unique identifier for the portfolio.
opt_prettybooleanNoProvides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
limitintegerNoResults per page. The number of objects to return per page. The value must be between 1 and 100.
offsetstringNoOffset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. Note: You can only pass in an offset that was returned to you via a previously paginated request.
opt_fieldsstring[]NoThis 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.

asana_portfolios_get_portfolio

Get a portfolio Parameters:
ParameterTypeRequiredDefaultDescription
portfolio_gidstringYesGlobally unique identifier for the portfolio.
opt_prettybooleanNoProvides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
opt_fieldsstring[]NoThis 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.

asana_portfolios_get_portfolio_membership

Get a portfolio membership Parameters:
ParameterTypeRequiredDefaultDescription
portfolio_membership_gidstringYesPortfolio Membership Gid
opt_prettybooleanNoProvides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
opt_fieldsstring[]NoThis 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.

asana_portfolios_get_portfolio_memberships

Get multiple portfolio memberships Parameters:
ParameterTypeRequiredDefaultDescription
portfoliostringNoThe portfolio to filter results on.
workspacestringNoThe workspace to filter results on.
userstringNoA string identifying a user. This can either be the string “me”, an email, or the gid of a user.
opt_prettybooleanNoProvides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
limitintegerNoResults per page. The number of objects to return per page. The value must be between 1 and 100.
offsetstringNoOffset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. Note: You can only pass in an offset that was returned to you via a previously paginated request.
opt_fieldsstring[]NoThis 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.

asana_portfolios_get_portfolio_memberships_for_portfolio

Get memberships from a portfolio Parameters:
ParameterTypeRequiredDefaultDescription
portfolio_gidstringYesGlobally unique identifier for the portfolio.
userstringNoA string identifying a user. This can either be the string “me”, an email, or the gid of a user.
opt_prettybooleanNoProvides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
limitintegerNoResults per page. The number of objects to return per page. The value must be between 1 and 100.
offsetstringNoOffset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. Note: You can only pass in an offset that was returned to you via a previously paginated request.
opt_fieldsstring[]NoThis 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.

asana_portfolios_get_portfolios

Get multiple portfolios Parameters:
ParameterTypeRequiredDefaultDescription
opt_prettybooleanNoProvides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
limitintegerNoResults per page. The number of objects to return per page. The value must be between 1 and 100.
offsetstringNoOffset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. Note: You can only pass in an offset that was returned to you via a previously paginated request.
workspacestringYesThe workspace or organization to filter portfolios on.
ownerstringNoThe user who owns the portfolio. Currently, API users can only get a list of portfolios that they themselves own, unless the request is made from a Service Account. In the case of a Service Account, if this parameter is specified, then all portfolios owned by this parameter are returned. Otherwise, all portfolios across the workspace are returned.
opt_fieldsstring[]NoThis 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.

asana_portfolios_remove_custom_field_setting_for_portfolio

Remove a custom field from a portfolio Parameters:
ParameterTypeRequiredDefaultDescription
portfolio_gidstringYesGlobally unique identifier for the portfolio.
opt_prettybooleanNoProvides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
dataobjectNoThe data value

asana_portfolios_remove_item_for_portfolio

Remove a portfolio item Parameters:
ParameterTypeRequiredDefaultDescription
portfolio_gidstringYesGlobally unique identifier for the portfolio.
opt_prettybooleanNoProvides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
dataobjectNoThe data value

asana_portfolios_remove_members_for_portfolio

Remove users from a portfolio Parameters:
ParameterTypeRequiredDefaultDescription
portfolio_gidstringYesGlobally unique identifier for the portfolio.
opt_prettybooleanNoProvides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
opt_fieldsstring[]NoThis 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.
dataobjectNoThe data value

asana_portfolios_update_portfolio

Update a portfolio Parameters:
ParameterTypeRequiredDefaultDescription
portfolio_gidstringYesGlobally unique identifier for the portfolio.
opt_prettybooleanNoProvides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
opt_fieldsstring[]NoThis 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.
dataobjectNoThe data value