diff --git a/descriptions/api.github.com/api.github.com.2022-11-28.json b/descriptions/api.github.com/api.github.com.2022-11-28.json
index 9c0c223fb6..d00a3dabde 100644
--- a/descriptions/api.github.com/api.github.com.2022-11-28.json
+++ b/descriptions/api.github.com/api.github.com.2022-11-28.json
@@ -19581,7 +19581,7 @@
       },
       "patch": {
         "summary": "Create or update custom properties for an organization",
-        "description": "Creates new or updates existing custom properties defined for an organization in a batch.\n\nTo use this endpoint, the authenticated user must be one of:\n  - An administrator for the organization.\n  - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.",
+        "description": "Creates new or updates existing custom properties defined for an organization in a batch.\n\nIf the property already exists, the existing property will be replaced with the new values.\nMissing optional values will fall back to default values, previous values will be overwritten.\nE.g. if a property exists with `values_editable_by: org_and_repo_actors` and it's updated without specifying `values_editable_by`, it will be updated to default value `org_actors`.\n\nTo use this endpoint, the authenticated user must be one of:\n  - An administrator for the organization.\n  - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.",
         "tags": [
           "orgs"
         ],
@@ -106129,6 +106129,16 @@
             "maxItems": 200,
             "nullable": true,
             "description": "An ordered list of the allowed values of the property.\nThe property can have up to 200 allowed values."
+          },
+          "values_editable_by": {
+            "type": "string",
+            "nullable": true,
+            "enum": [
+              "org_actors",
+              "org_and_repo_actors"
+            ],
+            "example": "org_actors",
+            "description": "Who can edit the values of the property"
           }
         },
         "required": [
diff --git a/descriptions/api.github.com/api.github.com.2022-11-28.yaml b/descriptions/api.github.com/api.github.com.2022-11-28.yaml
index 4cf2929dde..bdf5c2a0c9 100644
--- a/descriptions/api.github.com/api.github.com.2022-11-28.yaml
+++ b/descriptions/api.github.com/api.github.com.2022-11-28.yaml
@@ -14238,6 +14238,10 @@ paths:
       description: |-
         Creates new or updates existing custom properties defined for an organization in a batch.
 
+        If the property already exists, the existing property will be replaced with the new values.
+        Missing optional values will fall back to default values, previous values will be overwritten.
+        E.g. if a property exists with `values_editable_by: org_and_repo_actors` and it's updated without specifying `values_editable_by`, it will be updated to default value `org_actors`.
+
         To use this endpoint, the authenticated user must be one of:
           - An administrator for the organization.
           - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.
@@ -77775,6 +77779,14 @@ components:
           description: |-
             An ordered list of the allowed values of the property.
             The property can have up to 200 allowed values.
+        values_editable_by:
+          type: string
+          nullable: true
+          enum:
+          - org_actors
+          - org_and_repo_actors
+          example: org_actors
+          description: Who can edit the values of the property
       required:
       - value_type
     custom-property-value:
diff --git a/descriptions/api.github.com/api.github.com.json b/descriptions/api.github.com/api.github.com.json
index 9c0c223fb6..d00a3dabde 100644
--- a/descriptions/api.github.com/api.github.com.json
+++ b/descriptions/api.github.com/api.github.com.json
@@ -19581,7 +19581,7 @@
       },
       "patch": {
         "summary": "Create or update custom properties for an organization",
-        "description": "Creates new or updates existing custom properties defined for an organization in a batch.\n\nTo use this endpoint, the authenticated user must be one of:\n  - An administrator for the organization.\n  - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.",
+        "description": "Creates new or updates existing custom properties defined for an organization in a batch.\n\nIf the property already exists, the existing property will be replaced with the new values.\nMissing optional values will fall back to default values, previous values will be overwritten.\nE.g. if a property exists with `values_editable_by: org_and_repo_actors` and it's updated without specifying `values_editable_by`, it will be updated to default value `org_actors`.\n\nTo use this endpoint, the authenticated user must be one of:\n  - An administrator for the organization.\n  - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.",
         "tags": [
           "orgs"
         ],
@@ -106129,6 +106129,16 @@
             "maxItems": 200,
             "nullable": true,
             "description": "An ordered list of the allowed values of the property.\nThe property can have up to 200 allowed values."
+          },
+          "values_editable_by": {
+            "type": "string",
+            "nullable": true,
+            "enum": [
+              "org_actors",
+              "org_and_repo_actors"
+            ],
+            "example": "org_actors",
+            "description": "Who can edit the values of the property"
           }
         },
         "required": [
diff --git a/descriptions/api.github.com/api.github.com.yaml b/descriptions/api.github.com/api.github.com.yaml
index 4cf2929dde..bdf5c2a0c9 100644
--- a/descriptions/api.github.com/api.github.com.yaml
+++ b/descriptions/api.github.com/api.github.com.yaml
@@ -14238,6 +14238,10 @@ paths:
       description: |-
         Creates new or updates existing custom properties defined for an organization in a batch.
 
+        If the property already exists, the existing property will be replaced with the new values.
+        Missing optional values will fall back to default values, previous values will be overwritten.
+        E.g. if a property exists with `values_editable_by: org_and_repo_actors` and it's updated without specifying `values_editable_by`, it will be updated to default value `org_actors`.
+
         To use this endpoint, the authenticated user must be one of:
           - An administrator for the organization.
           - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.
@@ -77775,6 +77779,14 @@ components:
           description: |-
             An ordered list of the allowed values of the property.
             The property can have up to 200 allowed values.
+        values_editable_by:
+          type: string
+          nullable: true
+          enum:
+          - org_actors
+          - org_and_repo_actors
+          example: org_actors
+          description: Who can edit the values of the property
       required:
       - value_type
     custom-property-value:
diff --git a/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.json b/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.json
index f1f0421034..a1478f7aef 100644
--- a/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.json
+++ b/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.json
@@ -116260,7 +116260,7 @@
       },
       "patch": {
         "summary": "Create or update custom properties for an organization",
-        "description": "Creates new or updates existing custom properties defined for an organization in a batch.\n\nTo use this endpoint, the authenticated user must be one of:\n  - An administrator for the organization.\n  - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.",
+        "description": "Creates new or updates existing custom properties defined for an organization in a batch.\n\nIf the property already exists, the existing property will be replaced with the new values.\nMissing optional values will fall back to default values, previous values will be overwritten.\nE.g. if a property exists with `values_editable_by: org_and_repo_actors` and it's updated without specifying `values_editable_by`, it will be updated to default value `org_actors`.\n\nTo use this endpoint, the authenticated user must be one of:\n  - An administrator for the organization.\n  - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.",
         "tags": [
           "orgs"
         ],
@@ -116888,6 +116888,16 @@
                     "maxItems": 200,
                     "nullable": true,
                     "description": "An ordered list of the allowed values of the property.\nThe property can have up to 200 allowed values."
+                  },
+                  "values_editable_by": {
+                    "type": "string",
+                    "nullable": true,
+                    "enum": [
+                      "org_actors",
+                      "org_and_repo_actors"
+                    ],
+                    "example": "org_actors",
+                    "description": "Who can edit the values of the property"
                   }
                 },
                 "required": [
diff --git a/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.yaml b/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.yaml
index d8a92b554a..1e20234e1e 100644
--- a/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.yaml
+++ b/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.yaml
@@ -31823,6 +31823,10 @@ paths:
       description: |-
         Creates new or updates existing custom properties defined for an organization in a batch.
 
+        If the property already exists, the existing property will be replaced with the new values.
+        Missing optional values will fall back to default values, previous values will be overwritten.
+        E.g. if a property exists with `values_editable_by: org_and_repo_actors` and it's updated without specifying `values_editable_by`, it will be updated to default value `org_actors`.
+
         To use this endpoint, the authenticated user must be one of:
           - An administrator for the organization.
           - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.
@@ -31991,6 +31995,14 @@ paths:
                   description: |-
                     An ordered list of the allowed values of the property.
                     The property can have up to 200 allowed values.
+                values_editable_by:
+                  type: string
+                  nullable: true
+                  enum:
+                  - org_actors
+                  - org_and_repo_actors
+                  example: org_actors
+                  description: Who can edit the values of the property
               required:
               - value_type
             examples:
diff --git a/descriptions/api.github.com/dereferenced/api.github.com.deref.json b/descriptions/api.github.com/dereferenced/api.github.com.deref.json
index f1f0421034..a1478f7aef 100644
--- a/descriptions/api.github.com/dereferenced/api.github.com.deref.json
+++ b/descriptions/api.github.com/dereferenced/api.github.com.deref.json
@@ -116260,7 +116260,7 @@
       },
       "patch": {
         "summary": "Create or update custom properties for an organization",
-        "description": "Creates new or updates existing custom properties defined for an organization in a batch.\n\nTo use this endpoint, the authenticated user must be one of:\n  - An administrator for the organization.\n  - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.",
+        "description": "Creates new or updates existing custom properties defined for an organization in a batch.\n\nIf the property already exists, the existing property will be replaced with the new values.\nMissing optional values will fall back to default values, previous values will be overwritten.\nE.g. if a property exists with `values_editable_by: org_and_repo_actors` and it's updated without specifying `values_editable_by`, it will be updated to default value `org_actors`.\n\nTo use this endpoint, the authenticated user must be one of:\n  - An administrator for the organization.\n  - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.",
         "tags": [
           "orgs"
         ],
@@ -116888,6 +116888,16 @@
                     "maxItems": 200,
                     "nullable": true,
                     "description": "An ordered list of the allowed values of the property.\nThe property can have up to 200 allowed values."
+                  },
+                  "values_editable_by": {
+                    "type": "string",
+                    "nullable": true,
+                    "enum": [
+                      "org_actors",
+                      "org_and_repo_actors"
+                    ],
+                    "example": "org_actors",
+                    "description": "Who can edit the values of the property"
                   }
                 },
                 "required": [
diff --git a/descriptions/api.github.com/dereferenced/api.github.com.deref.yaml b/descriptions/api.github.com/dereferenced/api.github.com.deref.yaml
index d8a92b554a..1e20234e1e 100644
--- a/descriptions/api.github.com/dereferenced/api.github.com.deref.yaml
+++ b/descriptions/api.github.com/dereferenced/api.github.com.deref.yaml
@@ -31823,6 +31823,10 @@ paths:
       description: |-
         Creates new or updates existing custom properties defined for an organization in a batch.
 
+        If the property already exists, the existing property will be replaced with the new values.
+        Missing optional values will fall back to default values, previous values will be overwritten.
+        E.g. if a property exists with `values_editable_by: org_and_repo_actors` and it's updated without specifying `values_editable_by`, it will be updated to default value `org_actors`.
+
         To use this endpoint, the authenticated user must be one of:
           - An administrator for the organization.
           - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.
@@ -31991,6 +31995,14 @@ paths:
                   description: |-
                     An ordered list of the allowed values of the property.
                     The property can have up to 200 allowed values.
+                values_editable_by:
+                  type: string
+                  nullable: true
+                  enum:
+                  - org_actors
+                  - org_and_repo_actors
+                  example: org_actors
+                  description: Who can edit the values of the property
               required:
               - value_type
             examples:
diff --git a/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.json b/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.json
index 09c2e8934a..efb3e6cca9 100644
--- a/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.json
+++ b/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.json
@@ -36695,7 +36695,7 @@
       },
       "patch": {
         "summary": "Create or update custom properties for an enterprise",
-        "description": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nCreates new or updates existing custom properties defined for an enterprise in a batch.\n\nTo use this endpoint, the authenticated user must be an administrator for the enterprise.",
+        "description": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nCreates new or updates existing custom properties defined for an enterprise in a batch.\n\nIf the property already exists, the existing property will be replaced with the new values.\nMissing optional values will fall back to default values, previous values will be overwritten.\nE.g. if a property exists with `values_editable_by: org_and_repo_actors` and it's updated without specifying `values_editable_by`, it will be updated to default value `org_actors`.\n\nTo use this endpoint, the authenticated user must be an administrator for the enterprise.",
         "tags": [
           "enterprise-admin"
         ],
@@ -37534,6 +37534,16 @@
                     "maxItems": 200,
                     "nullable": true,
                     "description": "An ordered list of the allowed values of the property.\nThe property can have up to 200 allowed values."
+                  },
+                  "values_editable_by": {
+                    "type": "string",
+                    "nullable": true,
+                    "enum": [
+                      "org_actors",
+                      "org_and_repo_actors"
+                    ],
+                    "example": "org_actors",
+                    "description": "Who can edit the values of the property"
                   }
                 },
                 "required": [
@@ -148506,7 +148516,7 @@
       },
       "patch": {
         "summary": "Create or update custom properties for an organization",
-        "description": "Creates new or updates existing custom properties defined for an organization in a batch.\n\nTo use this endpoint, the authenticated user must be one of:\n  - An administrator for the organization.\n  - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.",
+        "description": "Creates new or updates existing custom properties defined for an organization in a batch.\n\nIf the property already exists, the existing property will be replaced with the new values.\nMissing optional values will fall back to default values, previous values will be overwritten.\nE.g. if a property exists with `values_editable_by: org_and_repo_actors` and it's updated without specifying `values_editable_by`, it will be updated to default value `org_actors`.\n\nTo use this endpoint, the authenticated user must be one of:\n  - An administrator for the organization.\n  - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.",
         "tags": [
           "orgs"
         ],
@@ -149134,6 +149144,16 @@
                     "maxItems": 200,
                     "nullable": true,
                     "description": "An ordered list of the allowed values of the property.\nThe property can have up to 200 allowed values."
+                  },
+                  "values_editable_by": {
+                    "type": "string",
+                    "nullable": true,
+                    "enum": [
+                      "org_actors",
+                      "org_and_repo_actors"
+                    ],
+                    "example": "org_actors",
+                    "description": "Who can edit the values of the property"
                   }
                 },
                 "required": [
diff --git a/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.yaml b/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.yaml
index b34e51456d..01e4f5af15 100644
--- a/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.yaml
+++ b/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.yaml
@@ -15903,6 +15903,10 @@ paths:
 
         Creates new or updates existing custom properties defined for an enterprise in a batch.
 
+        If the property already exists, the existing property will be replaced with the new values.
+        Missing optional values will fall back to default values, previous values will be overwritten.
+        E.g. if a property exists with `values_editable_by: org_and_repo_actors` and it's updated without specifying `values_editable_by`, it will be updated to default value `org_actors`.
+
         To use this endpoint, the authenticated user must be an administrator for the enterprise.
       tags:
       - enterprise-admin
@@ -16114,6 +16118,14 @@ paths:
                   description: |-
                     An ordered list of the allowed values of the property.
                     The property can have up to 200 allowed values.
+                values_editable_by:
+                  type: string
+                  nullable: true
+                  enum:
+                  - org_actors
+                  - org_and_repo_actors
+                  example: org_actors
+                  description: Who can edit the values of the property
               required:
               - value_type
             examples:
@@ -40630,6 +40642,10 @@ paths:
       description: |-
         Creates new or updates existing custom properties defined for an organization in a batch.
 
+        If the property already exists, the existing property will be replaced with the new values.
+        Missing optional values will fall back to default values, previous values will be overwritten.
+        E.g. if a property exists with `values_editable_by: org_and_repo_actors` and it's updated without specifying `values_editable_by`, it will be updated to default value `org_actors`.
+
         To use this endpoint, the authenticated user must be one of:
           - An administrator for the organization.
           - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.
diff --git a/descriptions/ghec/dereferenced/ghec.deref.json b/descriptions/ghec/dereferenced/ghec.deref.json
index 09c2e8934a..efb3e6cca9 100644
--- a/descriptions/ghec/dereferenced/ghec.deref.json
+++ b/descriptions/ghec/dereferenced/ghec.deref.json
@@ -36695,7 +36695,7 @@
       },
       "patch": {
         "summary": "Create or update custom properties for an enterprise",
-        "description": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nCreates new or updates existing custom properties defined for an enterprise in a batch.\n\nTo use this endpoint, the authenticated user must be an administrator for the enterprise.",
+        "description": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nCreates new or updates existing custom properties defined for an enterprise in a batch.\n\nIf the property already exists, the existing property will be replaced with the new values.\nMissing optional values will fall back to default values, previous values will be overwritten.\nE.g. if a property exists with `values_editable_by: org_and_repo_actors` and it's updated without specifying `values_editable_by`, it will be updated to default value `org_actors`.\n\nTo use this endpoint, the authenticated user must be an administrator for the enterprise.",
         "tags": [
           "enterprise-admin"
         ],
@@ -37534,6 +37534,16 @@
                     "maxItems": 200,
                     "nullable": true,
                     "description": "An ordered list of the allowed values of the property.\nThe property can have up to 200 allowed values."
+                  },
+                  "values_editable_by": {
+                    "type": "string",
+                    "nullable": true,
+                    "enum": [
+                      "org_actors",
+                      "org_and_repo_actors"
+                    ],
+                    "example": "org_actors",
+                    "description": "Who can edit the values of the property"
                   }
                 },
                 "required": [
@@ -148506,7 +148516,7 @@
       },
       "patch": {
         "summary": "Create or update custom properties for an organization",
-        "description": "Creates new or updates existing custom properties defined for an organization in a batch.\n\nTo use this endpoint, the authenticated user must be one of:\n  - An administrator for the organization.\n  - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.",
+        "description": "Creates new or updates existing custom properties defined for an organization in a batch.\n\nIf the property already exists, the existing property will be replaced with the new values.\nMissing optional values will fall back to default values, previous values will be overwritten.\nE.g. if a property exists with `values_editable_by: org_and_repo_actors` and it's updated without specifying `values_editable_by`, it will be updated to default value `org_actors`.\n\nTo use this endpoint, the authenticated user must be one of:\n  - An administrator for the organization.\n  - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.",
         "tags": [
           "orgs"
         ],
@@ -149134,6 +149144,16 @@
                     "maxItems": 200,
                     "nullable": true,
                     "description": "An ordered list of the allowed values of the property.\nThe property can have up to 200 allowed values."
+                  },
+                  "values_editable_by": {
+                    "type": "string",
+                    "nullable": true,
+                    "enum": [
+                      "org_actors",
+                      "org_and_repo_actors"
+                    ],
+                    "example": "org_actors",
+                    "description": "Who can edit the values of the property"
                   }
                 },
                 "required": [
diff --git a/descriptions/ghec/dereferenced/ghec.deref.yaml b/descriptions/ghec/dereferenced/ghec.deref.yaml
index b34e51456d..01e4f5af15 100644
--- a/descriptions/ghec/dereferenced/ghec.deref.yaml
+++ b/descriptions/ghec/dereferenced/ghec.deref.yaml
@@ -15903,6 +15903,10 @@ paths:
 
         Creates new or updates existing custom properties defined for an enterprise in a batch.
 
+        If the property already exists, the existing property will be replaced with the new values.
+        Missing optional values will fall back to default values, previous values will be overwritten.
+        E.g. if a property exists with `values_editable_by: org_and_repo_actors` and it's updated without specifying `values_editable_by`, it will be updated to default value `org_actors`.
+
         To use this endpoint, the authenticated user must be an administrator for the enterprise.
       tags:
       - enterprise-admin
@@ -16114,6 +16118,14 @@ paths:
                   description: |-
                     An ordered list of the allowed values of the property.
                     The property can have up to 200 allowed values.
+                values_editable_by:
+                  type: string
+                  nullable: true
+                  enum:
+                  - org_actors
+                  - org_and_repo_actors
+                  example: org_actors
+                  description: Who can edit the values of the property
               required:
               - value_type
             examples:
@@ -40630,6 +40642,10 @@ paths:
       description: |-
         Creates new or updates existing custom properties defined for an organization in a batch.
 
+        If the property already exists, the existing property will be replaced with the new values.
+        Missing optional values will fall back to default values, previous values will be overwritten.
+        E.g. if a property exists with `values_editable_by: org_and_repo_actors` and it's updated without specifying `values_editable_by`, it will be updated to default value `org_actors`.
+
         To use this endpoint, the authenticated user must be one of:
           - An administrator for the organization.
           - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.
diff --git a/descriptions/ghec/ghec.2022-11-28.json b/descriptions/ghec/ghec.2022-11-28.json
index a4ebcb43d6..eb3b522bb5 100644
--- a/descriptions/ghec/ghec.2022-11-28.json
+++ b/descriptions/ghec/ghec.2022-11-28.json
@@ -7464,7 +7464,7 @@
       },
       "patch": {
         "summary": "Create or update custom properties for an enterprise",
-        "description": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nCreates new or updates existing custom properties defined for an enterprise in a batch.\n\nTo use this endpoint, the authenticated user must be an administrator for the enterprise.",
+        "description": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nCreates new or updates existing custom properties defined for an enterprise in a batch.\n\nIf the property already exists, the existing property will be replaced with the new values.\nMissing optional values will fall back to default values, previous values will be overwritten.\nE.g. if a property exists with `values_editable_by: org_and_repo_actors` and it's updated without specifying `values_editable_by`, it will be updated to default value `org_actors`.\n\nTo use this endpoint, the authenticated user must be an administrator for the enterprise.",
         "tags": [
           "enterprise-admin"
         ],
@@ -26850,7 +26850,7 @@
       },
       "patch": {
         "summary": "Create or update custom properties for an organization",
-        "description": "Creates new or updates existing custom properties defined for an organization in a batch.\n\nTo use this endpoint, the authenticated user must be one of:\n  - An administrator for the organization.\n  - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.",
+        "description": "Creates new or updates existing custom properties defined for an organization in a batch.\n\nIf the property already exists, the existing property will be replaced with the new values.\nMissing optional values will fall back to default values, previous values will be overwritten.\nE.g. if a property exists with `values_editable_by: org_and_repo_actors` and it's updated without specifying `values_editable_by`, it will be updated to default value `org_actors`.\n\nTo use this endpoint, the authenticated user must be one of:\n  - An administrator for the organization.\n  - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.",
         "tags": [
           "orgs"
         ],
@@ -113116,6 +113116,16 @@
             "maxItems": 200,
             "nullable": true,
             "description": "An ordered list of the allowed values of the property.\nThe property can have up to 200 allowed values."
+          },
+          "values_editable_by": {
+            "type": "string",
+            "nullable": true,
+            "enum": [
+              "org_actors",
+              "org_and_repo_actors"
+            ],
+            "example": "org_actors",
+            "description": "Who can edit the values of the property"
           }
         },
         "required": [
diff --git a/descriptions/ghec/ghec.2022-11-28.yaml b/descriptions/ghec/ghec.2022-11-28.yaml
index e2b6a66047..932158a7d9 100644
--- a/descriptions/ghec/ghec.2022-11-28.yaml
+++ b/descriptions/ghec/ghec.2022-11-28.yaml
@@ -5332,6 +5332,10 @@ paths:
 
         Creates new or updates existing custom properties defined for an enterprise in a batch.
 
+        If the property already exists, the existing property will be replaced with the new values.
+        Missing optional values will fall back to default values, previous values will be overwritten.
+        E.g. if a property exists with `values_editable_by: org_and_repo_actors` and it's updated without specifying `values_editable_by`, it will be updated to default value `org_actors`.
+
         To use this endpoint, the authenticated user must be an administrator for the enterprise.
       tags:
       - enterprise-admin
@@ -19489,6 +19493,10 @@ paths:
       description: |-
         Creates new or updates existing custom properties defined for an organization in a batch.
 
+        If the property already exists, the existing property will be replaced with the new values.
+        Missing optional values will fall back to default values, previous values will be overwritten.
+        E.g. if a property exists with `values_editable_by: org_and_repo_actors` and it's updated without specifying `values_editable_by`, it will be updated to default value `org_actors`.
+
         To use this endpoint, the authenticated user must be one of:
           - An administrator for the organization.
           - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.
@@ -82474,6 +82482,14 @@ components:
           description: |-
             An ordered list of the allowed values of the property.
             The property can have up to 200 allowed values.
+        values_editable_by:
+          type: string
+          nullable: true
+          enum:
+          - org_actors
+          - org_and_repo_actors
+          example: org_actors
+          description: Who can edit the values of the property
       required:
       - value_type
     repository-rule-enforcement:
diff --git a/descriptions/ghec/ghec.json b/descriptions/ghec/ghec.json
index a4ebcb43d6..eb3b522bb5 100644
--- a/descriptions/ghec/ghec.json
+++ b/descriptions/ghec/ghec.json
@@ -7464,7 +7464,7 @@
       },
       "patch": {
         "summary": "Create or update custom properties for an enterprise",
-        "description": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nCreates new or updates existing custom properties defined for an enterprise in a batch.\n\nTo use this endpoint, the authenticated user must be an administrator for the enterprise.",
+        "description": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nCreates new or updates existing custom properties defined for an enterprise in a batch.\n\nIf the property already exists, the existing property will be replaced with the new values.\nMissing optional values will fall back to default values, previous values will be overwritten.\nE.g. if a property exists with `values_editable_by: org_and_repo_actors` and it's updated without specifying `values_editable_by`, it will be updated to default value `org_actors`.\n\nTo use this endpoint, the authenticated user must be an administrator for the enterprise.",
         "tags": [
           "enterprise-admin"
         ],
@@ -26850,7 +26850,7 @@
       },
       "patch": {
         "summary": "Create or update custom properties for an organization",
-        "description": "Creates new or updates existing custom properties defined for an organization in a batch.\n\nTo use this endpoint, the authenticated user must be one of:\n  - An administrator for the organization.\n  - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.",
+        "description": "Creates new or updates existing custom properties defined for an organization in a batch.\n\nIf the property already exists, the existing property will be replaced with the new values.\nMissing optional values will fall back to default values, previous values will be overwritten.\nE.g. if a property exists with `values_editable_by: org_and_repo_actors` and it's updated without specifying `values_editable_by`, it will be updated to default value `org_actors`.\n\nTo use this endpoint, the authenticated user must be one of:\n  - An administrator for the organization.\n  - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.",
         "tags": [
           "orgs"
         ],
@@ -113116,6 +113116,16 @@
             "maxItems": 200,
             "nullable": true,
             "description": "An ordered list of the allowed values of the property.\nThe property can have up to 200 allowed values."
+          },
+          "values_editable_by": {
+            "type": "string",
+            "nullable": true,
+            "enum": [
+              "org_actors",
+              "org_and_repo_actors"
+            ],
+            "example": "org_actors",
+            "description": "Who can edit the values of the property"
           }
         },
         "required": [
diff --git a/descriptions/ghec/ghec.yaml b/descriptions/ghec/ghec.yaml
index e2b6a66047..932158a7d9 100644
--- a/descriptions/ghec/ghec.yaml
+++ b/descriptions/ghec/ghec.yaml
@@ -5332,6 +5332,10 @@ paths:
 
         Creates new or updates existing custom properties defined for an enterprise in a batch.
 
+        If the property already exists, the existing property will be replaced with the new values.
+        Missing optional values will fall back to default values, previous values will be overwritten.
+        E.g. if a property exists with `values_editable_by: org_and_repo_actors` and it's updated without specifying `values_editable_by`, it will be updated to default value `org_actors`.
+
         To use this endpoint, the authenticated user must be an administrator for the enterprise.
       tags:
       - enterprise-admin
@@ -19489,6 +19493,10 @@ paths:
       description: |-
         Creates new or updates existing custom properties defined for an organization in a batch.
 
+        If the property already exists, the existing property will be replaced with the new values.
+        Missing optional values will fall back to default values, previous values will be overwritten.
+        E.g. if a property exists with `values_editable_by: org_and_repo_actors` and it's updated without specifying `values_editable_by`, it will be updated to default value `org_actors`.
+
         To use this endpoint, the authenticated user must be one of:
           - An administrator for the organization.
           - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.
@@ -82474,6 +82482,14 @@ components:
           description: |-
             An ordered list of the allowed values of the property.
             The property can have up to 200 allowed values.
+        values_editable_by:
+          type: string
+          nullable: true
+          enum:
+          - org_actors
+          - org_and_repo_actors
+          example: org_actors
+          description: Who can edit the values of the property
       required:
       - value_type
     repository-rule-enforcement:
diff --git a/descriptions/ghes-3.13/dereferenced/ghes-3.13.2022-11-28.deref.json b/descriptions/ghes-3.13/dereferenced/ghes-3.13.2022-11-28.deref.json
index cbae4966e7..44668e3508 100644
--- a/descriptions/ghes-3.13/dereferenced/ghes-3.13.2022-11-28.deref.json
+++ b/descriptions/ghes-3.13/dereferenced/ghes-3.13.2022-11-28.deref.json
@@ -113653,7 +113653,7 @@
       },
       "patch": {
         "summary": "Create or update custom properties for an organization",
-        "description": "Creates new or updates existing custom properties defined for an organization in a batch.\n\nTo use this endpoint, the authenticated user must be one of:\n  - An administrator for the organization.\n  - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.",
+        "description": "Creates new or updates existing custom properties defined for an organization in a batch.\n\nIf the property already exists, the existing property will be replaced with the new values.\nMissing optional values will fall back to default values, previous values will be overwritten.\nE.g. if a property exists with `values_editable_by: org_and_repo_actors` and it's updated without specifying `values_editable_by`, it will be updated to default value `org_actors`.\n\nTo use this endpoint, the authenticated user must be one of:\n  - An administrator for the organization.\n  - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.",
         "tags": [
           "orgs"
         ],
@@ -114281,6 +114281,16 @@
                     "maxItems": 200,
                     "nullable": true,
                     "description": "An ordered list of the allowed values of the property.\nThe property can have up to 200 allowed values."
+                  },
+                  "values_editable_by": {
+                    "type": "string",
+                    "nullable": true,
+                    "enum": [
+                      "org_actors",
+                      "org_and_repo_actors"
+                    ],
+                    "example": "org_actors",
+                    "description": "Who can edit the values of the property"
                   }
                 },
                 "required": [
diff --git a/descriptions/ghes-3.13/dereferenced/ghes-3.13.2022-11-28.deref.yaml b/descriptions/ghes-3.13/dereferenced/ghes-3.13.2022-11-28.deref.yaml
index 2453dbd6f3..d94b63a327 100644
--- a/descriptions/ghes-3.13/dereferenced/ghes-3.13.2022-11-28.deref.yaml
+++ b/descriptions/ghes-3.13/dereferenced/ghes-3.13.2022-11-28.deref.yaml
@@ -30474,6 +30474,10 @@ paths:
       description: |-
         Creates new or updates existing custom properties defined for an organization in a batch.
 
+        If the property already exists, the existing property will be replaced with the new values.
+        Missing optional values will fall back to default values, previous values will be overwritten.
+        E.g. if a property exists with `values_editable_by: org_and_repo_actors` and it's updated without specifying `values_editable_by`, it will be updated to default value `org_actors`.
+
         To use this endpoint, the authenticated user must be one of:
           - An administrator for the organization.
           - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.
@@ -30642,6 +30646,14 @@ paths:
                   description: |-
                     An ordered list of the allowed values of the property.
                     The property can have up to 200 allowed values.
+                values_editable_by:
+                  type: string
+                  nullable: true
+                  enum:
+                  - org_actors
+                  - org_and_repo_actors
+                  example: org_actors
+                  description: Who can edit the values of the property
               required:
               - value_type
             examples:
diff --git a/descriptions/ghes-3.13/dereferenced/ghes-3.13.deref.json b/descriptions/ghes-3.13/dereferenced/ghes-3.13.deref.json
index cbae4966e7..44668e3508 100644
--- a/descriptions/ghes-3.13/dereferenced/ghes-3.13.deref.json
+++ b/descriptions/ghes-3.13/dereferenced/ghes-3.13.deref.json
@@ -113653,7 +113653,7 @@
       },
       "patch": {
         "summary": "Create or update custom properties for an organization",
-        "description": "Creates new or updates existing custom properties defined for an organization in a batch.\n\nTo use this endpoint, the authenticated user must be one of:\n  - An administrator for the organization.\n  - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization.",
+        "description": "Creates new or updates existing custom properties defined for an organization in a batch.\n\nIf the property already exists, the existing property will be replaced with the new values.\nMissing optional values will fall back to default values, previous values will be overwritten.\nE.g. if a property exists with `values_editable_by: org_and_repo_actors` and it's updated without specifying `values_editable_by`, it will be updated to default value `org_actors`.\n\nTo use this endpoint, the authenticated user must be one of:\n  - An administrator for the organization.\n  - A user, or a user on a team, with the fine-grained permission of `custom_properties_org_definitions_manager` in the organization{"code":"internal","msg":"git-diff-tree: context deadline exceeded","meta":{"cause":"*fmt.wrapError"}}