Automated build docs: 2026-01-26 08:46:23

Author: asana-push-openapi-spec[bot]

defs/asana_oas.yaml

@@ -4587,9 +4587,14 @@ components:
             created_by:
               $ref: '#/components/schemas/UserCompact'
             custom_field_settings:
-              description: "<p><strong style={{ color: \"#4573D2\" }}>Full object
-                requires scope: </strong><code>custom_fields:read</code></p>\n\nArray
-                of custom field settings applied to the portfolio."
+              description: >-
+                <p><strong style={{ color: "#4573D2" }}>Full object requires scope:
+                </strong><code>custom_fields:read</code></p>
+
+
+                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.
               type: array
               items:
                 $ref: '#/components/schemas/CustomFieldSettingResponse'
@@ -4599,7 +4604,10 @@ components:
                 - description: The latest `status_update` posted to this portfolio.
                   nullable: true
             custom_fields:
-              description: Array of Custom Fields.
+              description: >-
+                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.
               type: array
               items:
                 $ref: '#/components/schemas/CustomFieldCompact'
@@ -4787,9 +4795,14 @@ components:
                   nullable: true
                   description: The latest `status_update` posted to this project.
             custom_field_settings:
-              description: "<p><strong style={{ color: \"#4573D2\" }}>Full object
-                requires scope: </strong><code>custom_fields:read</code></p>\n\nArray
-                of Custom Field Settings (in compact form)."
+              description: >-
+                <p><strong style={{ color: "#4573D2" }}>Full object requires scope:
+                </strong><code>custom_fields:read</code></p>
+
+
+                Array of custom field definitions that are enabled for the project.
+                These represent which custom fields are available to be used on tasks
+                within the project, but do not include any values.
               readOnly: true
               type: array
               items:
@@ -5315,7 +5328,10 @@ components:
         - type: object
           properties:
             custom_fields:
-              description: Array of Custom Fields.
+              description: >-
+                Array of custom field values applied directly to the project itself.
+                These represent the values set on the project,
+                not the fields available for tasks in the project.
               readOnly: true
               type: array
               items: