Merge pull request #56 from PhenoML/fern-bot/2026-02-08T15-51Z

feat: add code system detail retrieval and deletion methods

Author: gavinsharp

changelog.md

@@ -1,3 +1,17 @@
+## 5.1.0 - 2026-02-08
+* feat: add code system detail retrieval and deletion methods
+* Add comprehensive code system management capabilities with two new API methods for
+* retrieving detailed metadata and deleting custom code systems. Include enhanced
+* error handling and documentation updates for better API availability clarity.
+* Key changes:
+* Add `getCodeSystemDetail()` method to retrieve full metadata including timestamps and builtin status
+* Add `deleteCustomCodeSystem()` method to remove custom code systems with proper restrictions
+* Introduce ForbiddenError class for HTTP 403 responses with validation against builtin systems
+* Update upload request interface with replace option and enhanced validation documentation
+* Enhance search method documentation with availability notes for built-in vs custom systems
+* Add comprehensive test coverage for all new endpoints and error scenarios
+* 🌿 Generated with Fern
+
 ## 5.0.0 - 2026-02-07
 * feat: add workflow support to agents and simplify FHIR profile uploads
 * This release adds workflow integration capabilities for agents and streamlines

package.json

@@ -1,6 +1,6 @@
 {
     "name": "phenoml",
-    "version": "5.0.0",
+    "version": "5.1.0",
     "private": false,
     "repository": "github:PhenoML/phenoml-ts-sdk",
     "type": "commonjs",

reference.md

@@ -1329,6 +1329,153 @@ await client.construe.listAvailableCodeSystems();
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.construe.<a href="/src/api/resources/construe/client/Client.ts">getCodeSystemDetail</a>(codesystem, { ...params }) -> phenoml.GetCodeSystemDetailResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Returns full metadata for a single code system, including timestamps and builtin status.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.construe.getCodeSystemDetail("ICD-10-CM", {
+    version: "2025"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**codesystem:** `string` — Code system name (e.g., "ICD-10-CM", "SNOMED_CT_US_LITE")
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `phenoml.construe.GetConstrueCodesSystemsCodesystemRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Construe.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.construe.<a href="/src/api/resources/construe/client/Client.ts">deleteCustomCodeSystem</a>(codesystem, { ...params }) -> phenoml.DeleteCodeSystemResponse</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+Deletes a custom (non-builtin) code system and all its codes. Builtin systems cannot be deleted.
+Only available on dedicated instances. Large systems may take up to a minute to delete.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.construe.deleteCustomCodeSystem("CUSTOM_CODES", {
+    version: "version"
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**codesystem:** `string` — Code system name
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**request:** `phenoml.construe.DeleteConstrueCodesSystemsCodesystemRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `Construe.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>
@@ -1507,6 +1654,8 @@ await client.construe.getASpecificCode("ICD-10-CM", "E11.65", {
 
 Performs semantic similarity search using vector embeddings.
 
+**Availability**: This endpoint works for both **built-in and custom** code systems.
+
 **When to use**: Best for natural language queries where you want to find conceptually
 related codes, even when different terminology is used. The search understands meaning,
 not just keywords.
@@ -1598,6 +1747,10 @@ await client.construe.semanticSearchEmbeddingBased("ICD-10-CM", {
 
 Performs fast full-text search over code IDs and descriptions.
 
+**Availability**: This endpoint is only available for **built-in code systems**.
+Custom code systems uploaded via `/construe/upload` are not indexed for full-text search
+and will return empty results. Use `/search/semantic` to search custom code systems.
+
 **When to use**: Best for autocomplete UIs, code lookup, or when users know part of
 the code ID or specific keywords. Fast response times suitable for typeahead interfaces.
 

src/Client.ts

@@ -40,8 +40,8 @@ export class phenomlClient {
                 {
                     "X-Fern-Language": "JavaScript",
                     "X-Fern-SDK-Name": "phenoml",
-                    "X-Fern-SDK-Version": "5.0.0",
-                    "User-Agent": "phenoml/5.0.0",
+                    "X-Fern-SDK-Version": "5.1.0",
+                    "User-Agent": "phenoml/5.1.0",
                     "X-Fern-Runtime": core.RUNTIME.type,
                     "X-Fern-Runtime-Version": core.RUNTIME.version,
                 },