PortfolioCompact

Property	Type	Description
`gid`	string	Globally unique identifier of the resource, as a string.
`resource_type`	string	The base type of this resource.
`name`	string	The name of the portfolio.

Example JSON for PortfolioCompact:

{
  "gid": "12345",
  "resource_type": "portfolio",
  "name": "Bug Portfolio"
}

Portfolio

Property	Type	Description
`gid`	string	Globally unique identifier of the resource, as a string.
`resource_type`	string	The base type of this resource.
`name`	string	The name of the portfolio.
`archived`	boolean	Opt In. True if the portfolio is archived, false if not. Archived portfolios do not show in the UI by default and may be treated differently for queries.
`color`	string	Color of the portfolio. Click to show all enum values `dark-blue` `dark-brown` `dark-green` `dark-orange` `dark-pink` `dark-purple` `dark-red` `dark-teal` `dark-warm-gray` `light-blue` `light-brown` `light-green` `light-orange` `light-pink` `light-purple` `light-red` `light-teal` `light-warm-gray`
`start_on`	string (date)	The day on which work for this portfolio begins, or null if the portfolio has no start date. This takes a date with `YYYY-MM-DD` format. Note: `due_on` must be present in the request when setting or unsetting the `start_on` parameter. Additionally, `start_on` and `due_on` cannot be the same date.
`due_on`	string (date)	The day on which this portfolio is due. This takes a date with format YYYY-MM-DD.
`default_access_level`	string	The default access level when inviting new members to the portfolio Click to show all enum values `admin` `editor` `viewer`
`created_at`	string (date-time)	The time at which this resource was created.
`created_by`	object	A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.
`created_by.gid`	string	Globally unique identifier of the resource, as a string.
`created_by.resource_type`	string	The base type of this resource.
`created_by.name`	string	Read-only except when same user as requester. The user's name.
`custom_field_settings[]`	[object]	Array of custom field definitions that are enabled for the portfolio. These represent which custom fields are available to be used on items within the portfolio, but do not include any values.
`custom_field_settings[].gid`	string	Globally unique identifier of the resource, as a string.
`custom_field_settings[].resource_type`	string	The base type of this resource.
`custom_field_settings[].project`	object	Deprecated: new integrations should prefer the `parent` field. The id of the project that this custom field settings refers to.
`custom_field_settings[].project.gid`	string	Globally unique identifier of the resource, as a string.
`custom_field_settings[].project.resource_type`	string	The base type of this resource.
`custom_field_settings[].project.name`	string	Name of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.
`custom_field_settings[].is_important`	boolean	`is_important` is used in the Asana web application to determine if this custom field is displayed in the list/grid view of a project or portfolio.
`custom_field_settings[].parent`	object	The parent to which the custom field is applied. This can be a project or portfolio and indicates that the tasks or projects that the parent contains may be given custom field values for this custom field.
`custom_field_settings[].parent.gid`	string	Globally unique identifier of the resource, as a string.
`custom_field_settings[].parent.resource_type`	string	The base type of this resource.
`custom_field_settings[].parent.name`	string	Name of the project. This is generally a short sentence fragment that fits on a line in the UI for maximum readability. However, it can be longer.
`custom_field_settings[].custom_field`	object	The custom field that is applied to the `parent`.
`custom_field_settings[].custom_field.gid`	string	Globally unique identifier of the resource, as a string.
`custom_field_settings[].custom_field.resource_type`	string	The base type of this resource.
`custom_field_settings[].custom_field.name`	string	The name of the custom field.
`custom_field_settings[].custom_field.type`	string	Deprecated: new integrations should prefer the resource_subtype field. The type of the custom field. Must be one of the given values. Click to show all enum values `date` `enum` `multi_enum` `number` `people` `text`
`custom_field_settings[].custom_field.enum_options[]`	[object]	Conditional. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to working with enum options.
`custom_field_settings[].custom_field.enum_options[].gid`	string	Globally unique identifier of the resource, as a string.
`custom_field_settings[].custom_field.enum_options[].resource_type`	string	The base type of this resource.
`custom_field_settings[].custom_field.enum_options[].name`	string	The name of the enum option.
`custom_field_settings[].custom_field.enum_options[].enabled`	boolean	Whether or not the enum option is a selectable value for the custom field.
`custom_field_settings[].custom_field.enum_options[].color`	string	The color of the enum option. Defaults to `none`.
`custom_field_settings[].custom_field.enabled`	boolean	Conditional. This field applies only to custom field values and is not available for custom field definitions. Determines if the custom field is enabled or not. For more details, see the Custom Fields documentation.
`custom_field_settings[].custom_field.representation_type`	string	This field tells the type of the custom field. Click to show all enum values `custom_id` `date` `enum` `formula` `multi_enum` `number` `people` `reference` `text`
`custom_field_settings[].custom_field.id_prefix`	string	This field is the unique custom ID string for the custom field.
`custom_field_settings[].custom_field.input_restrictions[]`	[string]	Conditional. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.
`custom_field_settings[].custom_field.is_formula_field`	boolean	Conditional. This flag describes whether a custom field is a formula custom field.
`custom_field_settings[].custom_field.date_value`	object	Conditional. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.
`custom_field_settings[].custom_field.date_value.date`	string	A string representing the date in YYYY-MM-DD format.
`custom_field_settings[].custom_field.date_value.date_time`	string	A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.
`custom_field_settings[].custom_field.enum_value`	object	Conditional. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.
`custom_field_settings[].custom_field.enum_value.gid`	string	Globally unique identifier of the resource, as a string.
`custom_field_settings[].custom_field.enum_value.resource_type`	string	The base type of this resource.
`custom_field_settings[].custom_field.enum_value.name`	string	The name of the enum option.
`custom_field_settings[].custom_field.enum_value.enabled`	boolean	Whether or not the enum option is a selectable value for the custom field.
`custom_field_settings[].custom_field.enum_value.color`	string	The color of the enum option. Defaults to `none`.
`custom_field_settings[].custom_field.multi_enum_values[]`	[object]	Conditional. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.
`custom_field_settings[].custom_field.multi_enum_values[].gid`	string	Globally unique identifier of the resource, as a string.
`custom_field_settings[].custom_field.multi_enum_values[].resource_type`	string	The base type of this resource.
`custom_field_settings[].custom_field.multi_enum_values[].name`	string	The name of the enum option.
`custom_field_settings[].custom_field.multi_enum_values[].enabled`	boolean	Whether or not the enum option is a selectable value for the custom field.
`custom_field_settings[].custom_field.multi_enum_values[].color`	string	The color of the enum option. Defaults to `none`.
`custom_field_settings[].custom_field.number_value`	number	Conditional. This number is the value of a `number` custom field.
`custom_field_settings[].custom_field.text_value`	string	Conditional. This string is the value of a `text` custom field.
`custom_field_settings[].custom_field.display_value`	string	A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.
`custom_field_settings[].custom_field.description`	string	Opt In. The description of the custom field.
`custom_field_settings[].custom_field.precision`	integer	Only relevant for custom fields of type `Number`. This field dictates the number of places after the decimal to round to, i.e. 0 is integer values, 1 rounds to the nearest tenth, and so on. Must be between 0 and 6, inclusive. For percentage format, this may be unintuitive, as a value of 0.25 has a precision of 0, while a value of 0.251 has a precision of 1. This is due to 0.25 being displayed as 25%. The identifier format will always have a precision of 0.
`custom_field_settings[].custom_field.format`	string	The format of this custom field. Click to show all enum values `currency` `custom` `duration` `identifier` `none` `percentage`
`custom_field_settings[].custom_field.currency_code`	string	ISO 4217 currency code to format this custom field. This will be null if the `format` is not `currency`.
`custom_field_settings[].custom_field.custom_label`	string	This is the string that appears next to the custom field value. This will be null if the `format` is not `custom`.
`custom_field_settings[].custom_field.custom_label_position`	string	Only relevant for custom fields with `custom` format. This depicts where to place the custom label. This will be null if the `format` is not `custom`. Click to show all enum values `null` `prefix` `suffix`
`custom_field_settings[].custom_field.is_global_to_workspace`	boolean	This flag describes whether this custom field is available to every container in the workspace. Before project-specific custom fields, this field was always true.
`custom_field_settings[].custom_field.has_notifications_enabled`	boolean	Conditional. This flag describes whether a follower of a task with this field should receive inbox notifications from changes to this field.
`custom_field_settings[].custom_field.asana_created_field`	string	Conditional. A unique identifier to associate this field with the template source of truth. Click to show all enum values `a_v_requirements` `account_name` `actionable` `align_shipping_link` `align_status` `allotted_time` `appointment` `approval_stage` `approved` `article_series` `board_committee` `browser` `campaign_audience` `campaign_project_status` `campaign_regions` `channel_primary` `client_topic_type` `complete_by` `contact` `contact_email_address` `content_channels` `content_channels_needed` `content_stage` `content_type` `contract` `contract_status` `cost` `creation_stage` `creative_channel` `creative_needed` `creative_needs` `data_sensitivity` `deal_size` `delivery_appt` `delivery_appt_date` `department` `department_responsible` `design_request_needed` `design_request_type` `discussion_category` `do_this_task` `editorial_content_status` `editorial_content_tag` `editorial_content_type` `effort` `effort_level` `est_completion_date` `estimated_time` `estimated_value` `expected_cost` `external_steps_needed` `favorite_idea` `feedback_type` `financial` `funding_amount` `grant_application_process` `hiring_candidate_status` `idea_status` `ids_link` `ids_patient_link` `implementation_stage` `insurance` `interview_area` `interview_question_score` `itero_scan_link` `job_s_applied_to` `lab` `launch_status` `lead_status` `localization_language` `localization_market_team` `localization_status` `meeting_minutes` `meeting_needed` `minutes` `mrr` `must_localize` `name_of_foundation` `need_to_follow_up` `next_appointment` `next_steps_sales` `null` `num_people` `number_of_user_reports` `office_location` `onboarding_activity` `owner` `participants_needed` `patient_date_of_birth` `patient_email` `patient_phone` `patient_status` `phone_number` `planning_category` `point_of_contact` `position` `post_format` `prescription` `priority` `priority_level` `product` `product_stage` `progress` `project_size` `project_status` `proposed_budget` `publish_status` `reason_for_scan` `referral` `request_type` `research_status` `responsible_department` `responsible_team` `risk_assessment_status` `room_name` `sales_counterpart` `sentiment` `shipping_link` `social_channels` `stage` `status` `status_design` `status_of_initiative` `system_setup` `task_progress` `team` `team_marketing` `team_responsible` `time_it_takes_to_complete_tasks` `timeframe` `treatment_type` `type_work_requests_it` `use_agency` `user_name` `vendor_category` `vendor_type` `word_count`
`custom_field_settings[].custom_field.is_value_read_only`	boolean	Conditional. This flag describes whether a custom field is read only.
`custom_field_settings[].custom_field.created_by`	object	A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.
`custom_field_settings[].custom_field.created_by.gid`	string	Globally unique identifier of the resource, as a string.
`custom_field_settings[].custom_field.created_by.resource_type`	string	The base type of this resource.
`custom_field_settings[].custom_field.created_by.name`	string	Read-only except when same user as requester. The user's name.
`custom_field_settings[].custom_field.people_value[]`	[object]	Conditional. Only relevant for custom fields of type `people`. This array of compact user objects reflects the values of a `people` custom field.
`custom_field_settings[].custom_field.people_value[].gid`	string	Globally unique identifier of the resource, as a string.
`custom_field_settings[].custom_field.people_value[].resource_type`	string	The base type of this resource.
`custom_field_settings[].custom_field.people_value[].name`	string	Read-only except when same user as requester. The user's name.
`custom_field_settings[].custom_field.reference_value[]`	[object]	Conditional. Only relevant for custom fields of type `reference`. This array of objects reflects the values of a `reference` custom field.
`custom_field_settings[].custom_field.reference_value[].gid`	string	Globally unique identifier of the resource, as a string.
`custom_field_settings[].custom_field.reference_value[].resource_type`	string	The base type of this resource.
`custom_field_settings[].custom_field.reference_value[].name`	string	The name of the object.
`custom_field_settings[].custom_field.html_text_value`	string	Conditional. Only relevant for custom fields of type `text`. This is the HTML representation of the text value of a custom field, corresponding to the `text_value` plain-text field.
`custom_field_settings[].custom_field.privacy_setting`	string	The privacy setting of the custom field. Note: Administrators in your organization may restrict the values of `privacy_setting`. Click to show all enum values `private` `public` `public_with_guests`
`custom_field_settings[].custom_field.default_access_level`	string	The default access level when inviting new members to the custom field. This isn't applied when the `privacy_setting` is `private`, or the user is a guest. For local fields in a project or portfolio, the user must additionally have permission to modify the container itself. Click to show all enum values `admin` `editor` `user`
`custom_field_settings[].custom_field.resource_subtype`	string	The type of the custom field. Must be one of the given values. Click to show all enum values `date` `enum` `multi_enum` `number` `people` `reference` `text`
`current_status_update`	object	The latest `status_update` posted to this portfolio.
`current_status_update.gid`	string	Globally unique identifier of the resource, as a string.
`current_status_update.resource_type`	string	The base type of this resource.
`current_status_update.title`	string	The title of the status update.
`current_status_update.resource_subtype`	string	The subtype of this resource. Different subtypes retain many of the same fields and behavior, but may render differently in Asana or represent resources with different semantic meaning. The `resource_subtype`s for `status` objects represent the type of their parent. Click to show all enum values `goal_status_update` `portfolio_status_update` `project_status_update`
`custom_fields[]`	[object]	Array of custom field values applied directly to the portfolio itself. These represent the values set on the portfolio, not the fields available for items in the portfolio.
`custom_fields[].gid`	string	Globally unique identifier of the resource, as a string.
`custom_fields[].resource_type`	string	The base type of this resource.
`custom_fields[].name`	string	The name of the custom field.
`custom_fields[].type`	string	Deprecated: new integrations should prefer the resource_subtype field. The type of the custom field. Must be one of the given values. Click to show all enum values `date` `enum` `multi_enum` `number` `people` `text`
`custom_fields[].enum_options[]`	[object]	Conditional. Only relevant for custom fields of type `enum` or `multi_enum`. This array specifies the possible values which an `enum` custom field can adopt. To modify the enum options, refer to working with enum options.
`custom_fields[].enum_options[].gid`	string	Globally unique identifier of the resource, as a string.
`custom_fields[].enum_options[].resource_type`	string	The base type of this resource.
`custom_fields[].enum_options[].name`	string	The name of the enum option.
`custom_fields[].enum_options[].enabled`	boolean	Whether or not the enum option is a selectable value for the custom field.
`custom_fields[].enum_options[].color`	string	The color of the enum option. Defaults to `none`.
`custom_fields[].enabled`	boolean	Conditional. This field applies only to custom field values and is not available for custom field definitions. Determines if the custom field is enabled or not. For more details, see the Custom Fields documentation.
`custom_fields[].representation_type`	string	This field tells the type of the custom field. Click to show all enum values `custom_id` `date` `enum` `formula` `multi_enum` `number` `people` `text`
`custom_fields[].id_prefix`	string	This field is the unique custom ID string for the custom field.
`custom_fields[].input_restrictions[]`	[string]	Conditional. Only relevant for custom fields of type `reference`. This array of strings reflects the allowed types of objects that can be written to a `reference` custom field value.
`custom_fields[].is_formula_field`	boolean	Conditional. This flag describes whether a custom field is a formula custom field.
`custom_fields[].date_value`	object	Conditional. Only relevant for custom fields of type `date`. This object reflects the chosen date (and optionally, time) value of a `date` custom field. If no date is selected, the value of `date_value` will be `null`.
`custom_fields[].date_value.date`	string	A string representing the date in YYYY-MM-DD format.
`custom_fields[].date_value.date_time`	string	A string representing the date in ISO 8601 format. If no time value is selected, the value of `date-time` will be `null`.
`custom_fields[].enum_value`	object	Conditional. Only relevant for custom fields of type `enum`. This object is the chosen value of an `enum` custom field.
`custom_fields[].enum_value.gid`	string	Globally unique identifier of the resource, as a string.
`custom_fields[].enum_value.resource_type`	string	The base type of this resource.
`custom_fields[].enum_value.name`	string	The name of the enum option.
`custom_fields[].enum_value.enabled`	boolean	Whether or not the enum option is a selectable value for the custom field.
`custom_fields[].enum_value.color`	string	The color of the enum option. Defaults to `none`.
`custom_fields[].multi_enum_values[]`	[object]	Conditional. Only relevant for custom fields of type `multi_enum`. This object is the chosen values of a `multi_enum` custom field.
`custom_fields[].multi_enum_values[].gid`	string	Globally unique identifier of the resource, as a string.
`custom_fields[].multi_enum_values[].resource_type`	string	The base type of this resource.
`custom_fields[].multi_enum_values[].name`	string	The name of the enum option.
`custom_fields[].multi_enum_values[].enabled`	boolean	Whether or not the enum option is a selectable value for the custom field.
`custom_fields[].multi_enum_values[].color`	string	The color of the enum option. Defaults to `none`.
`custom_fields[].number_value`	number	Conditional. This number is the value of a `number` custom field.
`custom_fields[].text_value`	string	Conditional. This string is the value of a `text` custom field.
`custom_fields[].display_value`	string	A string representation for the value of the custom field. Integrations that don't require the underlying type should use this field to read values. Using this field will future-proof an app against new custom field types.
`members[]`	[object]	A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.
`members[].gid`	string	Globally unique identifier of the resource, as a string.
`members[].resource_type`	string	The base type of this resource.
`members[].name`	string	Read-only except when same user as requester. The user's name.
`owner`	object	A user object represents an account in Asana that can be given access to various workspaces, projects, and tasks.
`owner.gid`	string	Globally unique identifier of the resource, as a string.
`owner.resource_type`	string	The base type of this resource.
`owner.name`	string	Read-only except when same user as requester. The user's name.
`workspace`	object	Create-only. The workspace or organization that the portfolio belongs to.
`workspace.gid`	string	Globally unique identifier of the resource, as a string.
`workspace.resource_type`	string	The base type of this resource.
`workspace.name`	string	The name of the workspace.
`permalink_url`	string	A url that points directly to the object within Asana.
`public`	boolean	True if the portfolio is public to its workspace members.
`privacy_setting`	string	The privacy setting of the portfolio. Note: Administrators in your organization may restrict the values of `privacy_setting`. Click to show all enum values `members_only` `public_to_domain`
`project_templates[]`	[object]	Array of project templates that are in the portfolio
`project_templates[].gid`	string	Globally unique identifier of the resource, as a string.
`project_templates[].resource_type`	string	The base type of this resource.
`project_templates[].name`	string	Name of the project template.

Example JSON for Portfolio:

{
  "gid": "12345",
  "resource_type": "portfolio",
  "name": "Bug Portfolio",
  "archived": false,
  "color": "light-green",
  "start_on": "2019-09-14",
  "due_on": "2019-09-15",
  "default_access_level": "viewer",
  "created_at": "2012-02-22T02:06:58.147Z",
  "created_by": {
    "gid": "12345",
    "resource_type": "user",
    "name": "Greg Sanchez"
  },
  "custom_field_settings": [
    {
      "gid": "12345",
      "resource_type": "custom_field_setting",
      "project": {
        "gid": "12345",
        "resource_type": "project",
        "name": "Stuff to buy"
      },
      "is_important": false,
      "parent": {
        "gid": "12345",
        "resource_type": "project",
        "name": "Stuff to buy"
      },
      "custom_field": {
        "gid": "12345",
        "resource_type": "custom_field",
        "name": "Status",
        "type": "example string",
        "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",
        "is_formula_field": false,
        "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",
        "is_value_read_only": false,
        "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"
      }
    }
  ],
  "current_status_update": {
    "gid": "12345",
    "resource_type": "status_update",
    "title": "Status Update - Jun 15",
    "resource_subtype": "project_status_update"
  },
  "custom_fields": [
    {
      "gid": "12345",
      "resource_type": "custom_field",
      "name": "Status",
      "type": "example string",
      "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",
      "is_formula_field": false,
      "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"
    }
  ],
  "members": [
    {
      "gid": "12345",
      "resource_type": "user",
      "name": "Greg Sanchez"
    }
  ],
  "owner": {
    "gid": "12345",
    "resource_type": "user",
    "name": "Greg Sanchez"
  },
  "workspace": {
    "gid": "12345",
    "resource_type": "workspace",
    "name": "My Company Workspace"
  },
  "permalink_url": "https://app.asana.com/0/resource/123456789/list",
  "public": false,
  "privacy_setting": "members_only",
  "project_templates": [
    {
      "gid": "12345",
      "resource_type": "project_template",
      "name": "Packing list"
    }
  ]
}