Sample - Asana API
POST/portfolios/{portfolio_gid}/duplicate

Duplicate a portfolio

Creates a job to duplicate a portfolio and its selected elements asynchronously. Supply name and optionally specify which configurable elements to include through include; custom field settings and views are included automatically. Poll the returned job resource to monitor duplication progress.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 parameter · 1 body field
opt_fieldsarray<string>optional
A comma-separated selection of job and duplicated-resource properties to include in the response, such as `new_portfolio`, `new_project`, `new_graph_export`, or nested properties such as `new_portfolio.name`. Omit it to use the default response fields.

Optional portfolio duplication details wrapped in a data object. name is required when the body is provided.

dataobjectoptional

6 status codes
201Returns a job object in the `data` object for the asynchronous duplication process, including its identifier, status, and references to created resources.
dataobjectoptional
A *job* is an object representing a process that handles asynchronous work.
400Returned when `name` is missing or the request is malformed.
errorsarray<object>optional
401Returned when the request does not include a valid authentication token.
errorsarray<object>optional
403Returned when the authenticated user does not have access to the portfolio or the required `portfolios:write` scope.
errorsarray<object>optional
404Returned when the portfolio does not exist, or the method and path do not identify a known action.
errorsarray<object>optional
500Returned when the API encounters a server-side failure.
errorsarray<object>optional

Error handling

A 400 is returned when name is missing or the request is malformed. A 401 indicates that no valid authentication token was provided, while a 403 indicates that the authenticated user lacks access to the portfolio or the required portfolios:write scope. A 404 indicates that the portfolio does not exist, and a 500 indicates a server-side failure.