opf · myabc · Mar 8, 2026 · Mar 5, 2026 · Mar 3, 2026 · Mar 3, 2026
diff --git a/docs/api/apiv3/components/examples/portfolio.yml b/docs/api/apiv3/components/examples/portfolio.yml
@@ -54,3 +54,4 @@ value:
   createdAt: '2014-05-21T08:51:20.396Z'
   updatedAt: '2014-05-21T08:51:20.396Z'
   customField123: 123
+  customComment123: Why is the value 123?
diff --git a/docs/api/apiv3/components/examples/portfolio_body.yml b/docs/api/apiv3/components/examples/portfolio_body.yml
@@ -7,6 +7,7 @@ value:
   description:
     raw: Lorem **ipsum** dolor sit amet
   customField123: 123
+  customComment123: Because it is 123!
   _links:
     parent:
       href: "/api/v3/portfolios/123"

diff --git a/docs/api/apiv3/components/examples/program.yml b/docs/api/apiv3/components/examples/program.yml
@@ -54,3 +54,4 @@ value:
   createdAt: '2014-05-21T08:51:20.396Z'
   updatedAt: '2014-05-21T08:51:20.396Z'
   customField123: 123
+  customComment123: Why is the value 123?
diff --git a/docs/api/apiv3/components/examples/program_body.yml b/docs/api/apiv3/components/examples/program_body.yml
@@ -7,6 +7,7 @@ value:
   description:
     raw: Lorem **ipsum** dolor sit amet
   customField123: 123
+  customComment123: Because it is 123!
   _links:
     parent:
       href: "/api/v3/programs/123"

diff --git a/docs/api/apiv3/components/examples/project.yml b/docs/api/apiv3/components/examples/project.yml
@@ -54,3 +54,4 @@ value:
   createdAt: '2014-05-21T08:51:20.396Z'
   updatedAt: '2014-05-21T08:51:20.396Z'
   customField123: 123
+  customComment123: Why is the value 123?
diff --git a/docs/api/apiv3/components/examples/project_body.yml b/docs/api/apiv3/components/examples/project_body.yml
@@ -7,6 +7,7 @@ value:
   description:
     raw: Lorem **ipsum** dolor sit amet
   customField123: 123
+  customComment123: Because it is 123!
   _links:
     parent:
       href: "/api/v3/projects/123"

diff --git a/docs/api/apiv3/components/schemas/custom_comment_properties.yml b/docs/api/apiv3/components/schemas/custom_comment_properties.yml
@@ -0,0 +1,12 @@
+# Schema: CustomCommentProperties
+---
+type: object
+patternProperties:
+  "^customComment\\d+$":
+    type:
+      - "null"
+      - string
+    description: |-
+      A plain-text comment associated with a project custom field that has comments enabled.
+
+      The property is only present when the corresponding `customField{N}` has `has_comment` set to `true`.
diff --git a/docs/api/apiv3/components/schemas/group_model.yml b/docs/api/apiv3/components/schemas/group_model.yml
@@ -2,6 +2,7 @@
 ---
 allOf:
   - $ref: './principal_model.yml'
+  - $ref: "./custom_field_properties.yml"
   - type: object
     required:
       - _type