diff --git a/placement-api-ref/source/parameters.yaml b/placement-api-ref/source/parameters.yaml
index 42a8ddb76..a6cf8607d 100644
--- a/placement-api-ref/source/parameters.yaml
+++ b/placement-api-ref/source/parameters.yaml
@@ -448,6 +448,9 @@ resource_provider_parent_provider_uuid: &resource_provider_parent_provider_uuid
     The UUID of the immediate parent of the resource provider.
 resource_provider_parent_provider_uuid_1_14: &resource_provider_parent_provider_uuid_1_14
   <<: *resource_provider_parent_provider_uuid
+  description: >
+    The UUID of the immediate parent of the resource provider. Once set, the
+    parent of a resource provider cannot be changed.
   min_version: 1.14
 resource_provider_parent_provider_uuid_required:
   <<: *resource_provider_parent_provider_uuid