@api-now/cli 1.11.0 → 1.12.1

package/README.md

@@ -10,7 +10,8 @@ The **API NOW! CLI** is a robust, cross-platform command-line tool designed to m
 - **Interactive Onboarding**: Guided setup prompts for first-time users to configure organization names and slugs (validated against reserved keywords/taken values).
 - **Default Organization Management**: List organizations and pin a default workspace ID.
 - **Metadata and Media Uploads**: Create, list, and read blueprints, domains, and multimedia assets.
-- **Data Domain Management & Publishing**: Mutate data domains via declarative JSON patch diffing, transition data domain lifecycles (`draft`, `committed`, `published`), bump versions, run pre-publish validation, and publish domains directly to the Data Catalog.
+- **Data Domain Management & Publishing**: Search, list, create, mutate via declarative JSON patch diffing, transition lifecycles (`draft`, `committed`, `published`), bump versions, run pre-publish validation, and publish domains directly to the Data Catalog.
+- **API Model Management**: Search, list, create, and read API Model files and schemas with immediate parent folder resolution.
 - **Local & Remote Schema Validation**: Validate Data Domain and API Model schemas from local files, STDIN, or directly from remote organization files.
 - **Data Catalog Publishing**: Publish schemas and datasets to the global/private catalog with automatic semantic versioning support, deprecation, and unpublishing.
 - **Developer Formatting Options**: Toggle outputs between human-friendly ASCII tables and machine-readable JSON.
@@ -153,20 +154,32 @@ Manage Data Domain files, lifecycles, and catalog publications.
 
 #### List Data Domains (`domain list`)
 
-List all Data Domain files in an organization.
+List all Data Domain files in an organization (flat listing across all folders with immediate parent folder resolution).
 
 ```bash
 # List all domain files in an organization
 apinow domain list [--org <org_id>] [--parent <parent_id>]
 ```
 
+#### Search Data Domains (`domain search`)
+
+Search for Data Domain files by name or keyword across the organization.
+
+```bash
+# Search for domain files matching a query keyword
+apinow domain search "Billing" [--org <org_id>]
+
+# Search with explicit query keywords and folder/result limits
+apinow domain search --query Billing Payments --parent <parent_id> --limit 10
+```
+
 #### Create Data Domain (`domain create`)
 
 Create a new Data Domain file record in your organization, with optional local schema or STDIN upload.
 
 ```bash
 # Create a data domain metadata record
-apinow domain create --name "Billing Domain" [--org <org_id>]
+apinow domain create --name "Billing Domain" [--org <org_id>] [--parent <parent_id>]
 
 # Create a data domain and upload local schema media
 apinow domain create --name "Billing Domain" --media ./domain.json [--org <org_id>]
@@ -248,7 +261,59 @@ apinow domain publish --file <file_id> --ver 1.0.0 --scope public --name "Billin
 #   --changelog <changelog>  Changelog description for this version
 ```
 
-### 6. Schema Validation (`validate`)
+### 6. API Models (`api`)
+
+Manage API model files and schema definitions.
+
+#### List API Models (`api list`)
+
+List all API model files in an organization (flat listing across all folders with immediate parent folder resolution).
+
+```bash
+# List all API model files in an organization
+apinow api list [--org <org_id>] [--parent <parent_id>]
+```
+
+#### Search API Models (`api search`)
+
+Search for API model files by name or keyword across the organization.
+
+```bash
+# Search for API model files matching a query keyword
+apinow api search "Payments" [--org <org_id>]
+
+# Search with explicit query keywords and folder/result limits
+apinow api search --query Payments Billing --parent <parent_id> --limit 10
+```
+
+#### Create API Model (`api create`)
+
+Create a new API model file record in your organization, with optional local schema or STDIN upload.
+
+```bash
+# Create an API model metadata record
+apinow api create --name "Payments API" [--org <org_id>] [--parent <parent_id>]
+
+# Create an API model and upload local schema media (validates Core#ApiModel schema)
+apinow api create --name "Payments API" --media ./api.json [--org <org_id>]
+
+# Create an API model with schema piped from STDIN
+cat ./api.json | apinow api create --name "Piped API" --stdin [--org <org_id>]
+```
+
+#### Read API Model (`api read`)
+
+Read API model file metadata or schema media content.
+
+```bash
+# Read API model file metadata
+apinow api read --file <file_id> [--org <org_id>]
+
+# Read API model schema media content (JSON)
+apinow api read --file <file_id> --media [--org <org_id>]
+```
+
+### 7. Schema Validation (`validate`)
 
 Validate local or remote Data Domain and API Model schemas against syntax, modeling rules, and naming conventions.
 
@@ -266,7 +331,7 @@ cat domain.json | apinow validate --stdin
 apinow validate --org <org_id> --fid <file_id>
 ```
 
-### 7. Data Catalog (`catalog`)
+### 8. Data Catalog (`catalog`)
 
 Publish, inspect, and manage published catalog items.
 
@@ -290,7 +355,7 @@ apinow catalog deprecate <catalog_key> --reason "Superseded by v2" [--ver <versi
 apinow catalog unpublish <catalog_key> [--ver <version>]
 ```
 
-### 8. Runtime (`runtime`)
+### 9. Runtime (`runtime`)
 
 Administrative operations for the API runtime. This command allows API Now! platform managers and administrators to modify runtime users directly.