feat: add '--schema' and '--data' options for various commands (#1691)

* feat: add '--schema' and '--data' options for various commands to enhance JSON payload handling and schema discovery

* feat: add '--json' and '--json-compact' options for output formatting and enhance '--schema' command behavior

Author: ramya18101

docs/auth0_acul_config_list.md

@@ -7,6 +7,8 @@ has_toc: false
 
 List Universal Login rendering configurations with optional filters and pagination.
 
+Use '--schema' to see available query parameters.
+
 ## Usage
 ```
 auth0 acul config list [flags]
@@ -17,6 +19,7 @@ auth0 acul config list [flags]
 ```
   auth0 acul config list --prompt reset-password
   auth0 acul config list --rendering-mode advanced --include-fields true --fields head_tags,context_configuration
+  auth0 acul config list --schema
 ```
 
 
@@ -33,6 +36,7 @@ auth0 acul config list [flags]
       --prompt string           Filter by the Universal Login prompt.
   -q, --query string            Advanced query.
       --rendering-mode string   Filter by the rendering mode (advanced or standard).
+      --schema                  Print the request payload schema for this command and exit. Use with --json or --json-compact for machine-readable output.
       --screen string           Filter by the Universal Login screen.
 ```
 

docs/auth0_acul_config_set.md

@@ -7,6 +7,10 @@ has_toc: false
 
 Set the rendering settings for a specific screen.
 
+Provide the config with `--file` (or its alias `--data`), which accepts inline JSON, an `@file.json` reference, or a file path.
+
+Use '--schema' to print the request payload schema and exit.
+
 ## Usage
 ```
 auth0 acul config set [flags]
@@ -19,13 +23,20 @@ auth0 acul config set [flags]
   auth0 acul config set <screen-name> --file settings.json
   auth0 acul config set signup-id --file settings.json
   auth0 acul config set login-id
+  auth0 acul config set signup-id --data '{"rendering_mode":"advanced"}'
+  auth0 acul config set signup-id --data @settings.json
+  auth0 acul config set --schema
 ```
 
 
 ## Flags
 
 ```
-  -f, --file string   File to save the rendering configs to.
+      --data string    Alias for --file. Rendering config as inline JSON, an @file.json reference, or a file path.
+  -f, --file string    File to save the rendering configs to.
+      --json           Output in json format.
+      --json-compact   Output in compact json format.
+      --schema         Print the request payload schema for this command and exit. Use with --json or --json-compact for machine-readable output.
 ```
 
 

docs/auth0_domains_create.md

@@ -11,6 +11,9 @@ To create interactively, use `auth0 domains create` with no arguments.
 
 To create non-interactively, supply the domain name, type, policy and other information through the flags.
 
+Use '--schema' to print the request payload schema and exit.
+Use '--data' to supply the full JSON payload (validated against the schema before sending).
+
 ## Usage
 ```
 auth0 domains create [flags]
@@ -22,23 +25,34 @@ auth0 domains create [flags]
   auth0 domains create
   auth0 domains create --domain <domain-name>
   auth0 domains create --domain <domain-name> --policy recommended
-  auth0 domains create --domain <domain-name> --policy recommended --metadata '{"key1":"value1","key2":"value2"}' 
+  auth0 domains create --domain <domain-name> --policy recommended --metadata '{"key1":"value1","key2":"value2"}'
   auth0 domains create --domain <domain-name> --policy recommended --type auth0
   auth0 domains create --domain <domain-name> --policy recommended --type auth0 --ip-header "cf-connecting-ip"
   auth0 domains create -d <domain-name> -p recommended -t auth0 -i "cf-connecting-ip" --json
   auth0 domains create -d <domain-name> -p recommended -t auth0 -i "cf-connecting-ip" --json-compact
+
+  # Discover the payload schema
+  auth0 domains create --schema
+  auth0 domains create --schema --json
+
+  # JSON input mode (for agents and automation)
+  auth0 domains create --data '{"domain":"login.example.com","type":"auth0_managed_certs"}'
+  auth0 domains create --data @domain.json
+  cat domain.json | auth0 domains create
 ```
 
 
 ## Flags
 
 ```
+      --data string           JSON payload for the operation, as a JSON string or file path (@file.json). Can also be piped via stdin.
   -d, --domain string         Domain name.
   -i, --ip-header string      The HTTP header to fetch the client's IP address.
       --json                  Output in json format.
       --json-compact          Output in compact json format.
   -m, --metadata string       The Custom Domain Metadata, formatted as JSON.
   -p, --policy string         The TLS version policy. Can be either 'compatible' or 'recommended'.
+      --schema                Print the request payload schema for this command and exit. Use with --json or --json-compact for machine-readable output.
   -t, --type string           Custom domain provisioning type. Must be 'auth0' for Auth0-managed certs or 'self' for self-managed certs.
   -v, --verification string   *DEPRECATED* Custom domain verification method. Must be 'txt'.
 ```

docs/auth0_domains_list.md

@@ -7,6 +7,9 @@ has_toc: false
 
 List your existing custom domains. To create one, run: `auth0 domains create`.
 
+Use '--schema' to see available query parameters.
+Use '--query' to filter results via a JSON object (any API-supported parameter works immediately).
+
 ## Usage
 ```
 auth0 domains list [flags]
@@ -21,6 +24,10 @@ auth0 domains list [flags]
   auth0 domains ls --json-compact
   auth0 domains ls --csv
   auth0 domains ls --filter "domain:demo* AND status:pending_verification"
+  auth0 domains list --schema
+  auth0 domains list --schema --json
+  auth0 domains list --query '{"take":10}'
+  auth0 domains list --query '{"take":10}' --json
 ```
 
 
@@ -31,6 +38,8 @@ auth0 domains list [flags]
       --filter string   Filter custom domains (EA-only).
       --json            Output in json format.
       --json-compact    Output in compact json format.
+  -q, --query string    Filter results with a JSON object of query parameters. Any API-supported parameter works immediately. Run '--schema' to see documented parameters. On offset-paginated endpoints, add "include_totals":true to receive total counts and a pagination hint (without it the API returns a bare array and no hint can be given).
+      --schema          Print the request payload schema for this command and exit. Use with --json or --json-compact for machine-readable output.
       --sort string     Sort by a field (EA-only). Only 'domain' is supported.
 ```
 

docs/auth0_domains_update.md

@@ -11,6 +11,9 @@ To update interactively, use `auth0 domains update` with no arguments.
 
 To update non-interactively, supply the domain name, type, policy and other information through the flags.
 
+Use '--schema' to print the request payload schema and exit.
+Use '--data' to supply the full JSON payload (validated against the schema before sending).
+
 ## Usage
 ```
 auth0 domains update [flags]
@@ -25,17 +28,28 @@ auth0 domains update [flags]
   auth0 domains update <domain-id> --metadata '{"key1":"value1","key2":null}'
   auth0 domains update <domain-id> -p compatible -i "cf-connecting-ip" --json
   auth0 domains update <domain-id> -p compatible -i "cf-connecting-ip" --json-compact
+
+  # Discover the payload schema
+  auth0 domains update --schema
+  auth0 domains update --schema --json
+
+  # JSON input mode (for agents and automation)
+  auth0 domains update <domain-id> --data '{"tls_policy":"recommended"}'
+  auth0 domains update <domain-id> --data @domain.json
+  cat domain.json | auth0 domains update <domain-id>
 ```
 
 
 ## Flags
 
 ```
+      --data string        JSON payload for the operation, as a JSON string or file path (@file.json). Can also be piped via stdin.
   -i, --ip-header string   The HTTP header to fetch the client's IP address.
       --json               Output in json format.
       --json-compact       Output in compact json format.
   -m, --metadata string    The Custom Domain Metadata, formatted as JSON.
   -p, --policy string      The TLS version policy. Can be either 'compatible' or 'recommended'.
+      --schema             Print the request payload schema for this command and exit. Use with --json or --json-compact for machine-readable output.
 ```
 
 

docs/auth0_email_templates_update.md

@@ -31,19 +31,30 @@ auth0 email templates update [flags]
   auth0 email templates update welcome --enabled=true --body "$(cat path/to/body.html)" --from "welcome@example.com" --lifetime 6100 --subject "Welcome" --url "https://example.com"
   auth0 email templates update welcome -e=true -b "$(cat path/to/body.html)" -f "welcome@example.com" -l 6100 -s "Welcome" -u "https://example.com" --json
   auth0 email templates update welcome -e=true -b "$(cat path/to/body.html)" -f "welcome@example.com" -l 6100 -s "Welcome" -u "https://example.com" --json-compact
+
+  # Discover the payload schema
+  auth0 email templates update --schema
+  auth0 email templates update --schema --json
+
+  # JSON input mode (for agents and automation)
+  auth0 email templates update welcome --data '{"body":"<html>Welcome!</html>","enabled":true}'
+  auth0 email templates update welcome --data @template.json
+  cat template.json | auth0 email templates update welcome
 ```
 
 
 ## Flags
 
 ```
   -b, --body string      Body of the email template.
+      --data string      JSON payload for the operation, as a JSON string or file path (@file.json). Can also be piped via stdin.
   -e, --enabled          Whether the template is enabled (true) or disabled (false). (default true)
       --force            Skip confirmation.
   -f, --from string      Sender's 'from' email address.
       --json             Output in json format.
       --json-compact     Output in compact json format.
   -l, --lifetime int     Lifetime in seconds that the link within the email will be valid for.
+      --schema           Print the request payload schema for this command and exit. Use with --json or --json-compact for machine-readable output.
   -s, --subject string   Subject line of the email.
   -u, --url string       URL to redirect the user to after a successful action.
 ```

docs/auth0_logs_list.md

@@ -7,6 +7,9 @@ has_toc: false
 
 Display the tenant logs allowing to filter using Lucene query syntax.
 
+Use '--schema' to see available query parameters.
+Use '--query' to filter results via a JSON object (any API-supported parameter works immediately).
+
 ## Usage
 ```
 auth0 logs list [flags]
@@ -27,6 +30,10 @@ auth0 logs list [flags]
   auth0 logs ls --json
   auth0 logs ls --json-compact
   auth0 logs ls --csv
+  auth0 logs list --schema
+  auth0 logs list --schema --json
+  auth0 logs list --query '{"per_page":5,"include_totals":true}'
+  auth0 logs list --query '{"per_page":5}' --json
 ```
 
 
@@ -39,6 +46,8 @@ auth0 logs list [flags]
       --json-compact    Output in compact json format.
   -n, --number int      Number of log entries to show. Minimum 1, maximum 1000. (default 100)
   -p, --picker          Allows to toggle from list of logs and view a selected log in detail
+  -q, --query string    Filter results with a JSON object of query parameters. Any API-supported parameter works immediately. Run '--schema' to see documented parameters. On offset-paginated endpoints, add "include_totals":true to receive total counts and a pagination hint (without it the API returns a bare array and no hint can be given).
+      --schema          Print the request payload schema for this command and exit. Use with --json or --json-compact for machine-readable output.
 ```
 
 

docs/auth0_universal-login_prompts_update.md

@@ -18,12 +18,17 @@ auth0 universal-login prompts update [flags]
   auth0 universal-login prompts update <prompt>
   auth0 universal-login prompts update <prompt> --language <language>
   auth0 ul prompts update signup -l es
+
+  # JSON input mode (for agents and automation)
+  auth0 ul prompts update signup -l es --data '{"signup":{"title":"Sign Up"}}'
+  auth0 ul prompts update signup -l es --data @signup.json
 ```
 
 
 ## Flags
 
 ```
+      --data string       JSON payload for the operation, as a JSON string or file path (@file.json). Can also be piped via stdin.
   -l, --language string   Language of the custom text. (default "en")
 ```
 

docs/auth0_universal-login_update.md

@@ -24,6 +24,15 @@ auth0 universal-login update [flags]
   auth0 ul update -a "#FF4F40" -b "#2A2E35" -l "https://example.com/logo.png"
   auth0 ul update -a "#FF4F40" -b "#2A2E35" -l "https://example.com/logo.png" --json
   auth0 ul update -a "#FF4F40" -b "#2A2E35" -l "https://example.com/logo.png" --json-compact
+
+  # Discover the payload schema
+  auth0 universal-login update --schema
+  auth0 universal-login update --schema --json
+
+  # JSON input mode (for agents and automation)
+  auth0 ul update --data '{"colors":{"primary":"#FF4F40","page_background":"#2A2E35"}}'
+  auth0 ul update --data @branding.json
+  cat branding.json | auth0 ul update
 ```
 
 
@@ -32,11 +41,13 @@ auth0 universal-login update [flags]
 ```
   -a, --accent string       Accent color.
   -b, --background string   Page background color
+      --data string         JSON payload for the operation, as a JSON string or file path (@file.json). Can also be piped via stdin.
   -f, --favicon string      URL for the favicon. Must use HTTPS.
   -c, --font string         URL for the custom font. The URL must point to a font file and not a stylesheet. Must use HTTPS.
       --json                Output in json format.
       --json-compact        Output in compact json format.
   -l, --logo string         URL for the logo. Must use HTTPS.
+      --schema              Print the request payload schema for this command and exit. Use with --json or --json-compact for machine-readable output.
 ```