diff --git a/descriptions-next/api.github.com/api.github.com.2022-11-28.json b/descriptions-next/api.github.com/api.github.com.2022-11-28.json
index af6ae92ce3..211185aa56 100644
--- a/descriptions-next/api.github.com/api.github.com.2022-11-28.json
+++ b/descriptions-next/api.github.com/api.github.com.2022-11-28.json
@@ -19659,7 +19659,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"
         ],
@@ -107694,6 +107694,21 @@
             },
             "maxItems": 200,
             "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",
+              "null"
+            ],
+            "enum": [
+              "org_actors",
+              "org_and_repo_actors",
+              null
+            ],
+            "description": "Who can edit the values of the property",
+            "examples": [
+              "org_actors"
+            ]
           }
         },
         "required": [
diff --git a/descriptions-next/api.github.com/api.github.com.2022-11-28.yaml b/descriptions-next/api.github.com/api.github.com.2022-11-28.yaml
index 528b69180f..18d67821e9 100644
--- a/descriptions-next/api.github.com/api.github.com.2022-11-28.yaml
+++ b/descriptions-next/api.github.com/api.github.com.2022-11-28.yaml
@@ -14275,6 +14275,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.
@@ -78258,6 +78262,17 @@ 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
+          - 'null'
+          enum:
+          - org_actors
+          - org_and_repo_actors
+          - 
+          description: Who can edit the values of the property
+          examples:
+          - org_actors
       required:
       - value_type
     custom-property-value:
diff --git a/descriptions-next/api.github.com/api.github.com.json b/descriptions-next/api.github.com/api.github.com.json
index af6ae92ce3..211185aa56 100644
--- a/descriptions-next/api.github.com/api.github.com.json
+++ b/descriptions-next/api.github.com/api.github.com.json
@@ -19659,7 +19659,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"
         ],
@@ -107694,6 +107694,21 @@
             },
             "maxItems": 200,
             "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",
+              "null"
+            ],
+            "enum": [
+              "org_actors",
+              "org_and_repo_actors",
+              null
+            ],
+            "description": "Who can edit the values of the property",
+            "examples": [
+              "org_actors"
+            ]
           }
         },
         "required": [
diff --git a/descriptions-next/api.github.com/api.github.com.yaml b/descriptions-next/api.github.com/api.github.com.yaml
index 528b69180f..18d67821e9 100644
--- a/descriptions-next/api.github.com/api.github.com.yaml
+++ b/descriptions-next/api.github.com/api.github.com.yaml
@@ -14275,6 +14275,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.
@@ -78258,6 +78262,17 @@ 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
+          - 'null'
+          enum:
+          - org_actors
+          - org_and_repo_actors
+          - 
+          description: Who can edit the values of the property
+          examples:
+          - org_actors
       required:
       - value_type
     custom-property-value:
diff --git a/descriptions-next/api.github.com/dereferenced/api.github.com.2022-11-28.deref.json b/descriptions-next/api.github.com/dereferenced/api.github.com.2022-11-28.deref.json
index e1275ea6a7..8f05da5674 100644
--- a/descriptions-next/api.github.com/dereferenced/api.github.com.2022-11-28.deref.json
+++ b/descriptions-next/api.github.com/dereferenced/api.github.com.2022-11-28.deref.json
@@ -133908,7 +133908,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"
         ],
@@ -134597,6 +134597,21 @@
                     },
                     "maxItems": 200,
                     "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",
+                      "null"
+                    ],
+                    "enum": [
+                      "org_actors",
+                      "org_and_repo_actors",
+                      null
+                    ],
+                    "description": "Who can edit the values of the property",
+                    "examples": [
+                      "org_actors"
+                    ]
                   }
                 },
                 "required": [
diff --git a/descriptions-next/api.github.com/dereferenced/api.github.com.2022-11-28.deref.yaml b/descriptions-next/api.github.com/dereferenced/api.github.com.2022-11-28.deref.yaml
index c2f16b14f2..b32bc74f6a 100644
--- a/descriptions-next/api.github.com/dereferenced/api.github.com.2022-11-28.deref.yaml
+++ b/descriptions-next/api.github.com/dereferenced/api.github.com.2022-11-28.deref.yaml
@@ -32705,6 +32705,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.
@@ -32879,6 +32883,17 @@ 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
+                  - 'null'
+                  enum:
+                  - org_actors
+                  - org_and_repo_actors
+                  - 
+                  description: Who can edit the values of the property
+                  examples:
+                  - org_actors
               required:
               - value_type
             examples:
diff --git a/descriptions-next/api.github.com/dereferenced/api.github.com.deref.json b/descriptions-next/api.github.com/dereferenced/api.github.com.deref.json
index e1275ea6a7..8f05da5674 100644
--- a/descriptions-next/api.github.com/dereferenced/api.github.com.deref.json
+++ b/descriptions-next/api.github.com/dereferenced/api.github.com.deref.json
@@ -133908,7 +133908,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"
         ],
@@ -134597,6 +134597,21 @@
                     },
                     "maxItems": 200,
                     "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",
+                      "null"
+                    ],
+                    "enum": [
+                      "org_actors",
+                      "org_and_repo_actors",
+                      null
+                    ],
+                    "description": "Who can edit the values of the property",
+                    "examples": [
+                      "org_actors"
+                    ]
                   }
                 },
                 "required": [
diff --git a/descriptions-next/api.github.com/dereferenced/api.github.com.deref.yaml b/descriptions-next/api.github.com/dereferenced/api.github.com.deref.yaml
index c2f16b14f2..b32bc74f6a 100644
--- a/descriptions-next/api.github.com/dereferenced/api.github.com.deref.yaml
+++ b/descriptions-next/api.github.com/dereferenced/api.github.com.deref.yaml
@@ -32705,6 +32705,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.
@@ -32879,6 +32883,17 @@ 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
+                  - 'null'
+                  enum:
+                  - org_actors
+                  - org_and_repo_actors
+                  - 
+                  description: Who can edit the values of the property
+                  examples:
+                  - org_actors
               required:
               - value_type
             examples:
diff --git a/descriptions-next/ghec/dereferenced/ghec.2022-11-28.deref.json b/descriptions-next/ghec/dereferenced/ghec.2022-11-28.deref.json
index 0c509214ac..3b5d8c0124 100644
--- a/descriptions-next/ghec/dereferenced/ghec.2022-11-28.deref.json
+++ b/descriptions-next/ghec/dereferenced/ghec.2022-11-28.deref.json
@@ -40456,7 +40456,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"
         ],
@@ -41373,6 +41373,21 @@
                     },
                     "maxItems": 200,
                     "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",
+                      "null"
+                    ],
+                    "enum": [
+                      "org_actors",
+                      "org_and_repo_actors",
+                      null
+                    ],
+                    "description": "Who can edit the values of the property",
+                    "examples": [
+                      "org_actors"
+                    ]
                   }
                 },
                 "required": [
@@ -168414,7 +168429,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"
         ],
@@ -169103,6 +169118,21 @@
                     },
                     "maxItems": 200,
                     "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",
+                      "null"
+                    ],
+                    "enum": [
+                      "org_actors",
+                      "org_and_repo_actors",
+                      null
+                    ],
+                    "description": "Who can edit the values of the property",
+                    "examples": [
+                      "org_actors"
+                    ]
                   }
                 },
                 "required": [
diff --git a/descriptions-next/ghec/dereferenced/ghec.2022-11-28.deref.yaml b/descriptions-next/ghec/dereferenced/ghec.2022-11-28.deref.yaml
index 289687c26b..f648f64f44 100644
--- a/descriptions-next/ghec/dereferenced/ghec.2022-11-28.deref.yaml
+++ b/descriptions-next/ghec/dereferenced/ghec.2022-11-28.deref.yaml
@@ -16440,6 +16440,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
@@ -16657,6 +16661,17 @@ 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
+                  - 'null'
+                  enum:
+                  - org_actors
+                  - org_and_repo_actors
+                  - 
+                  description: Who can edit the values of the property
+                  examples:
+                  - org_actors
               required:
               - value_type
             examples:
@@ -41621,6 +41636,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-next/ghec/dereferenced/ghec.deref.json b/descriptions-next/ghec/dereferenced/ghec.deref.json
index 0c509214ac..3b5d8c0124 100644
--- a/descriptions-next/ghec/dereferenced/ghec.deref.json
+++ b/descriptions-next/ghec/dereferenced/ghec.deref.json
@@ -40456,7 +40456,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"
         ],
@@ -41373,6 +41373,21 @@
                     },
                     "maxItems": 200,
                     "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",
+                      "null"
+                    ],
+                    "enum": [
+                      "org_actors",
+                      "org_and_repo_actors",
+                      null
+                    ],
+                    "description": "Who can edit the values of the property",
+                    "examples": [
+                      "org_actors"
+                    ]
                   }
                 },
                 "required": [
@@ -168414,7 +168429,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"
         ],
@@ -169103,6 +169118,21 @@
                     },
                     "maxItems": 200,
                     "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",
+                      "null"
+                    ],
+                    "enum": [
+                      "org_actors",
+                      "org_and_repo_actors",
+                      null
+                    ],
+                    "description": "Who can edit the values of the property",
+                    "examples": [
+                      "org_actors"
+                    ]
                   }
                 },
                 "required": [
diff --git a/descriptions-next/ghec/dereferenced/ghec.deref.yaml b/descriptions-next/ghec/dereferenced/ghec.deref.yaml
index 289687c26b..f648f64f44 100644
--- a/descriptions-next/ghec/dereferenced/ghec.deref.yaml
+++ b/descriptions-next/ghec/dereferenced/ghec.deref.yaml
@@ -16440,6 +16440,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
@@ -16657,6 +16661,17 @@ 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
+                  - 'null'
+                  enum:
+                  - org_actors
+                  - org_and_repo_actors
+                  - 
+                  description: Who can edit the values of the property
+                  examples:
+                  - org_actors
               required:
               - value_type
             examples:
@@ -41621,6 +41636,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-next/ghec/ghec.2022-11-28.json b/descriptions-next/ghec/ghec.2022-11-28.json
index 5375f0c451..9b7335b756 100644
--- a/descriptions-next/ghec/ghec.2022-11-28.json
+++ b/descriptions-next/ghec/ghec.2022-11-28.json
@@ -7486,7 +7486,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"
         ],
@@ -26942,7 +26942,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"
         ],
@@ -114446,6 +114446,21 @@
             },
             "maxItems": 200,
             "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",
+              "null"
+            ],
+            "enum": [
+              "org_actors",
+              "org_and_repo_actors",
+              null
+            ],
+            "description": "Who can edit the values of the property",
+            "examples": [
+              "org_actors"
+            ]
           }
         },
         "required": [
diff --git a/descriptions-next/ghec/ghec.2022-11-28.yaml b/descriptions-next/ghec/ghec.2022-11-28.yaml
index 2d879d23d7..eaca406898 100644
--- a/descriptions-next/ghec/ghec.2022-11-28.yaml
+++ b/descriptions-next/ghec/ghec.2022-11-28.yaml
@@ -5343,6 +5343,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
@@ -19533,6 +19537,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.
@@ -83069,6 +83077,17 @@ 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
+          - 'null'
+          enum:
+          - org_actors
+          - org_and_repo_actors
+          - 
+          description: Who can edit the values of the property
+          examples:
+          - org_actors
       required:
       - value_type
     repository-rule-enforcement:
diff --git a/descriptions-next/ghec/ghec.json b/descriptions-next/ghec/ghec.json
index 5375f0c451..9b7335b756 100644
--- a/descriptions-next/ghec/ghec.json
+++ b/descriptions-next/ghec/ghec.json
@@ -7486,7 +7486,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"
         ],
@@ -26942,7 +26942,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"
         ],
@@ -114446,6 +114446,21 @@
             },
             "maxItems": 200,
             "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",
+              "null"
+            ],
+            "enum": [
+              "org_actors",
+              "org_and_repo_actors",
+              null
+            ],
+            "description": "Who can edit the values of the property",
+            "examples": [
+              "org_actors"
+            ]
           }
         },
         "required": [
diff --git a/descriptions-next/ghec/ghec.yaml b/descriptions-next/ghec/ghec.yaml
index 2d879d23d7..eaca406898 100644
--- a/descriptions-next/ghec/ghec.yaml
+++ b/descriptions-next/ghec/ghec.yaml
@@ -5343,6 +5343,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
@@ -19533,6 +19537,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.
@@ -83069,6 +83077,17 @@ 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
+          - 'null'
+          enum:
+          - org_actors
+          - org_and_repo_actors
+          - 
+          description: Who can edit the values of the property
+          examples:
+          - org_actors
     {"code":"internal","msg":"git-diff-tree: context deadline exceeded","meta":{"cause":"*fmt.wrapError"}}