Create a portfolio

POST

/portfolios

Creates a new portfolio in the given workspace with the supplied name.

Note that portfolios created in the Asana UI may have some state
(like the “Priority” custom field) which is automatically added
to the portfolio when it is created. Portfolios created via our
API will not be created with the same initial state to allow
integrations to create their own starting state on a portfolio.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://app.asana.com/api/1.0/portfolios' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": {
        "name": "Bug Portfolio",
        "color": "light-green",
        "members": [
            "52164",
            "15363"
        ],
        "workspace": "167589"
    }
}'

Response Example

201 - Example 1

{
    "data": {
        "gid": "12345",
        "resource_type": "task",
        "name": "Bug Portfolio",
        "color": "light-green",
        "created_at": "2012-02-22T02:06:58.147Z",
        "created_by": {
            "gid": "12345",
            "resource_type": "task",
            "name": "Greg Sanchez"
        },
        "custom_field_settings": [
            {
                "gid": "12345",
                "resource_type": "task",
                "custom_field": {
                    "gid": "12345",
                    "resource_type": "task",
                    "display_value": "blue",
                    "enabled": true,
                    "enum_options": [
                        {
                            "gid": "12345",
                            "resource_type": "task",
                            "color": "blue",
                            "enabled": true,
                            "name": "Low"
                        }
                    ],
                    "name": "Status",
                    "number_value": 5.2,
                    "resource_subtype": "text",
                    "text_value": "Some Value",
                    "type": "text",
                    "currency_code": "EUR",
                    "custom_label": "gold pieces",
                    "custom_label_position": "suffix",
                    "description": "Development team priority",
                    "format": "custom",
                    "has_notifications_enabled": true,
                    "is_global_to_workspace": true,
                    "precision": 2,
                    "created_by": {
                        "gid": "12345",
                        "resource_type": "task",
                        "name": "Greg Sanchez"
                    },
                    "enum_value": {
                        "gid": "12345",
                        "resource_type": "task",
                        "color": "blue",
                        "enabled": true,
                        "name": "Low"
                    },
                    "multi_enum_values": [
                        {
                            "gid": "12345",
                            "resource_type": "task",
                            "color": "blue",
                            "enabled": true,
                            "name": "Low"
                        }
                    ]
                },
                "is_important": false,
                "parent": {
                    "gid": "12345",
                    "resource_type": "task",
                    "name": "Stuff to buy"
                },
                "project": {
                    "gid": "12345",
                    "resource_type": "task",
                    "name": "Stuff to buy"
                }
            }
        ],
        "due_on": "2019-09-15",
        "members": [
            {
                "gid": "12345",
                "resource_type": "task",
                "name": "Greg Sanchez"
            }
        ],
        "owner": {
            "gid": "12345",
            "resource_type": "task",
            "name": "Greg Sanchez"
        },
        "permalink_url": "https://app.asana.com/0/resource/123456789/list",
        "start_on": "2019-09-14",
        "workspace": {
            "gid": "12345",
            "resource_type": "task",
            "name": "My Company Workspace"
        }
    }
}

Request

Body Params application/json

Examples

Responses

🟢201Successfully created portfolio.

application/json

Body

🟠400400

🟠401401

🟠403403

🟠404404

🔴500500

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

Get multiple portfolios

Delete a portfolio