diff --git a/entity-api-spec.yaml b/entity-api-spec.yaml
index 647b4aed..ac1e09fe 100644
--- a/entity-api-spec.yaml
+++ b/entity-api-spec.yaml
@@ -1,7 +1,7 @@
 openapi: 3.0.3
 info:
   description: 'The HuBMAP Entity API is a standard RESTful web service with create, update and read operations for the standard HuBMAP provenance graph entities.'
-  version: 2.4.6
+  version: 2.5.3
   title: HuBMAP Entity API
   contact:
     name: HuBMAP Help Desk
@@ -693,7 +693,7 @@ components:
               - Targeted-Shotgun-LC-MS
               - TMT-LC-MS
               - WGS
-          description: 'The data or assay types contained in this dataset as a json array of strings.  Each is an assay code from [assay types](https://github.com/hubmapconsortium/search-api/blob/main/src/search-schema/data/definitions/enums/assay_types.yaml).'
+          description: 'The data or assay types contained in this dataset as a json array of strings.'
         collections:
           readOnly: true
           type: array
@@ -1134,7 +1134,7 @@ components:
               - Targeted-Shotgun-LC-MS
               - TMT-LC-MS
               - WGS
-          description: 'The data or assay types contained in this dataset as a json array of strings.  Each is an assay code from [assay types](https://github.com/hubmapconsortium/search-api/blob/main/src/search-schema/data/definitions/enums/assay_types.yaml).'
+          description: 'The data or assay types contained in this dataset as a json array of strings.'
         collections:
           readOnly: true
           type: array
diff --git a/src/schema/provenance_schema.yaml b/src/schema/provenance_schema.yaml
index f88898ef..cb30a34d 100644
--- a/src/schema/provenance_schema.yaml
+++ b/src/schema/provenance_schema.yaml
@@ -404,7 +404,7 @@ ENTITIES:
         type: list
         indexed: true
         required_on_create: false
-        description: "The data or assay types contained in this dataset as a json array of strings.  Each is an assay code from [assay types](https://github.com/hubmapconsortium/search-api/blob/main/src/search-schema/data/definitions/enums/assay_types.yaml)."
+        description: "The data or assay types contained in this dataset as a json array of strings."
       dataset_type:
         before_property_create_validators:
           - validate_recognized_dataset_type
@@ -972,7 +972,7 @@ ENTITIES:
         type: string
         indexed: true
         immutable: true
-        description: "Organ code specifier, only set if sample_type == organ.  Valid values found in: [organ types](https://github.com/hubmapconsortium/search-api/blob/main/src/search-schema/data/definitions/enums/organ_types.yaml)"
+        description: "Organ code specifier, only set if sample_category == organ"
       organ_other:
         type: string
         indexed: true