Sign in
Portfolios

Add a custom field to a portfolio

<b>Required scope: </b><code>portfolios:write</code>

Custom fields are associated with portfolios by way of custom field settings. This method creates a setting for the portfolio.

post/portfolios/{portfolio_gid}/addCustomFieldSetting

Request

  • Base URL: https://app.asana.com/api/1.0
  • URL: https://app.asana.com/api/1.0/portfolios/{portfolio_gid}/addCustomFieldSetting
  • Auth: one of:
    • HTTP bearer
    • OAuth 2 (authorization code, authorization URL https://app.asana.com/-/oauth_authorize, token URL https://app.asana.com/-/oauth_token, scopes: portfolios:write)

Request body

Example request

{
  "data": {
    "custom_field": "14916",
    "is_important": true,
    "insert_before": "1331",
    "insert_after": "1331"
  }
}

Response

Successfully added the custom field to the portfolio.

Example response

{
  "data": {
    "gid": "12345",
    "resource_type": "custom_field_setting",
    "project": {
      "gid": "12345",
      "resource_type": "project",
      "name": "Stuff to buy",
      "resource_subtype": "default_project"
    },
    "parent": {
      "gid": "12345",
      "resource_type": "project",
      "name": "Stuff to buy",
      "resource_subtype": "default_project"
    },
    "custom_field": {
      "gid": "12345",
      "resource_type": "custom_field",
      "name": "Status",
      "enum_options": [
        {
          "gid": "12345",
          "resource_type": "enum_option",
          "name": "Low",
          "enabled": true,
          "color": "blue"
        }
      ],
      "enabled": true,
      "representation_type": "number",
      "id_prefix": "ID",
      "input_restrictions": [
        "task"
      ],
      "date_value": {
        "date": "2024-08-23",
        "date_time": "2024-08-23T22:00:00.000Z"
      },
      "enum_value": {
        "gid": "12345",
        "resource_type": "enum_option",
        "name": "Low",
        "enabled": true,
        "color": "blue"
      },
      "multi_enum_values": [
        {
          "gid": "12345",
          "resource_type": "enum_option",
          "name": "Low",
          "enabled": true,
          "color": "blue"
        }
      ],
      "number_value": 5.2,
      "text_value": "Some Value",
      "display_value": "blue",
      "description": "Development team priority",
      "precision": 2,
      "format": "custom",
      "currency_code": "EUR",
      "custom_label": "gold pieces",
      "custom_label_position": "suffix",
      "is_global_to_workspace": true,
      "has_notifications_enabled": true,
      "asana_created_field": "priority",
      "created_by": {
        "gid": "12345",
        "resource_type": "user",
        "name": "Greg Sanchez"
      },
      "people_value": [
        {
          "gid": "12345",
          "resource_type": "user",
          "name": "Greg Sanchez"
        }
      ],
      "reference_value": [
        {
          "gid": "12345",
          "resource_type": "task",
          "name": "Bug Task"
        }
      ],
      "html_text_value": "<body>Some Value</body>",
      "privacy_setting": "public_with_guests",
      "default_access_level": "user",
      "resource_subtype": "text"
    }
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.