Changelog

uac-cli-1.3.0 (2026/10/01)

Enhancements

  • Added: uac task clone — create a new Task (or Workflow) from an existing one’s definition, with optional field overrides; always assigns a new sys id regardless of retain_sys_ids/UAC_CLI_NO_RETAIN_SYS_IDS (#238)

  • Added: key=@<path> file reference syntax for any command argument — loads the field’s value from a file’s UTF-8 text contents instead of typing it inline, usable on the command line or in an -a argument file (#239)

  • Added: UAC_CLI_NO_RETAIN_SYS_IDS changes the implicit retain_sys_ids value from true to false for create requests with input payloads; explicit command arguments still take precedence (#78)

  • Added: uac task-instance get-zos-jobsteps — retrieve restartable z/OS job steps for a task instance (#231)

  • Added: uac task-instance select-zos-jobstep — select one or more z/OS job steps for rerun by step number (#231)

  • Added: uac task-instance deselect-zos-jobstep — deselect one or more z/OS job steps by step number (#231)

  • Added: uac task-instance select-zos-jobsteps-to-end — select all z/OS job steps from a given step through the end (#231)

  • Added: uac task-instance approval-approve and approval-reject accept an optional operational memo via --input/-i (#232)

  • Added: uac task-instance get and retrieve-output accept current_output_only parameter (#233)

  • Added: uac task-instance list and list-advanced accept top_level_workflow_instance_id parameter (#233)

  • Added: uac task-instance list-advanced accepts limit parameter (#233)

  • Changed: uac task-instance list and list-advanced responses now include createdTime, summary, topLevelWorkflowId, and topLevelWorkflowName fields (#233)

  • Changed: uac trigger list default table columns now include description after name (#230)

  • Changed: uac report list returns the correct single-object response; previously incorrectly wrapped in a list for table output (#224)

  • Changed: uac task list no longer injects implicit response_fields=* when table format is active; only user-supplied response_fields values are forwarded (#229)

  • Changed: uac promotion update-schedule routes scheduleId as a path parameter only, no longer included in the request payload (#225)

  • Changed: uac oms-server create and update restrict strict_bsrvc_membership boolean coercion to JSON input; positional arguments pass the value as-is (#226)

  • Changed: uac task create/update and uac trigger create/update no longer strip unrecognised fields client-side; the UAC controller ignores unknown fields natively (#227)

Fixes

  • Fixed: UAC_CLI_NO_VERIFY_SSL now controls SSL verification as documented (#211)

  • Fixed: uac-api now warns when read-only task execution statistics (avgRunTime, firstRun, lastRun, runCount, and related fields) are supplied on task create or update requests (#222)

  • Fixed: uac-api now warns when read-only bundle metadata fields (created, createdBy, updated, updatedBy) are supplied on bundle create or update requests (#234)

  • Fixed: uac-api now warns when read-only variable metadata fields (created, createdBy, updated, updatedBy) are supplied on variable create or update requests (#235)

  • Fixed: Commands that do not support --format (for example uac task-instance retrieve-output and show-variables) no longer print nothing when output_options.default_stdout_format is set to table; they now always print JSON as documented (#240)

  • Fixed: Table output (--format table) no longer raises an error when the response is a single object instead of a list, for example uac report list (#240)

  • Fixed: key=@<path> file reference values no longer include a trailing newline character added by the file’s format/editor, which previously could make an otherwise-correct value (for example logLevel=@file.txt) fail server-side validation; line endings (LF/CRLF/CR) and a UTF-8 BOM are also now normalized, and read errors (missing file, directory, permission denied, invalid encoding) raise a clear message instead of a raw traceback (#241)

uac-cli-1.2.0 (2026/05/08)

Deprecations and Breaking Changes

  • Deprecated: ~/.uac/profiles.yml is deprecated in favour of ~/.uac/config.yml. The CLI will warn on every invocation until migrated. Run uac config migrate to upgrade (#219)

Enhancements

Features

  • Added: --format/-f flag for list commands to select output format: json (default) or table (#75)

  • Added: --columns/-c flag for table output to specify which fields to display; supports dot notation for nested fields (#75)

  • Added: output_options section in ~/.uac/config.yml for configuring default output format, table appearance (box, show_lines, expand, padding, max_column_width), and per-command default columns (table_columns) (#219)

  • Added: uac config init — create ~/.uac/config.yml with a default profile (#219)

  • Added: uac config get — print current configuration with sensitive values masked (#219)

  • Added: uac config add-profile — add or update a connection profile in config.yml (#219)

  • Added: uac config migrate — one-time migration from ~/.uac/profiles.yml to ~/.uac/config.yml (#219)

  • Added: JSON Schema validation for config.yml with clear error messages pointing to the offending field (#219)

uac-cli-1.1.0 (2025/10/01)

Deprecations and Breaking Changes

Deprecated Parameters (will be removed in future versions)

  • Deprecated: The task parameter in uac webhook list will be removed in future versions. Use taskname instead (#120)

  • Deprecated: The operational_memo parameter in uac task-instance retrieve-output will be removed in future versions (#117)

  • Deprecated: The name parameter in uac virtual-resource list will be removed in future versions. Use resourcename instead (#119)

  • Deprecated: The name parameter in uac user change-password will be removed in future versions. Use user_name instead (#96)

  • Deprecated: The name parameter in uac server-operation download-log will be removed in future versions. Use log_name instead (#96)

Removed Commands (not suggesting breaking change)

  • Removed: Invalid command uac trigger create-temp removed as it is covered by uac trigger create (#188)

  • Removed: universal-event pushq: Non functional. Functionality can be covered by push. Command is removed (#202)

Enhancements

Features

  • Added: New global parameter --ca-bundle and UAC_CLI_CA_BUNDLE environment variable (#38)

  • Added: server-operations commands: Added -s/--select option for JSON output filtering (#125)

New Commands Added and alignment with UC 7.9

  • Added: uac bundle create-by-business-services

  • Added: uac calendar get-custom-days

  • Added: uac cluster-node healthcheck

  • Added: uac custom-day list-qualifying-periods

  • Added: uac ldap update-bind-password

  • Added: uac oauth-single-sign-on get-settings

  • Added: uac oauth-single-sign-on update-settings

  • Added: uac promotion cancel-promotion-schedule

  • Added: uac promotion create

  • Added: uac promotion delete

  • Added: uac promotion-target create

  • Added: uac promotion-target delete

  • Added: uac promotion-target get

  • Added: uac promotion-target list

  • Added: uac promotion-target refresh-target-agents

  • Added: uac promotion-target update

  • Added: uac server-operation bulk-export-activity

  • Added: uac server-operation bulk-export-audit

  • Added: uac server-operation bulk-export-history

  • Added: uac server-operation ldap-refresh

  • Added: uac server-operation ldap-refresh-async

  • Added: uac server-operation pause-cluster-node

  • Added: uac server-operation resume-cluster-node

  • Added: uac task-instance approval-approve

  • Added: uac task-instance approval-reject

  • Added: uac task-instance get

  • Added: uac task-instance list-advanced

  • Added: uac task-instance patch-instance

  • Added: uac task-instance set-started

  • Added: uac task-instance set-variable

  • Added: uac trigger list-component-events

  • Added: uac trigger set-skip-count

  • Added: uac trigger set-time

  • Added: uac trigger trigger-now

  • Added: uac universal-template get-extension-archive

  • Added: uac universal-template restore-default-icon

  • Added: uac user add-group

  • Added: uac user delete-group

  • Added: uac user get-groups

  • Added: uac user get-preference

  • Added: uac user list-preferences

  • Added: uac user update-preference

  • Added: uac webhook assign-execution-user

  • Added: uac webhook enable-disable

Enhanced Parameter Support

  • Changed: Improved parameter coverage through command line parameters, and alignment with updated OpenAPI specification of UC

Documentation Updates

  • Added: Section with Tips & Tricks and reorganization of Getting Started → Usage Chapters

  • Added: Description on snake_case and camelCase usage

  • Changed: Improved installation instructions for Linux

  • Changed: Improved examples

  • Changed: Improved command documentation

Fixes

  • Fixed: Aligned help messages and parameter support with OpenAPI specification

  • Fixed: Improved messages in case of errors (#71)

  • Fixed: Added metadata on uac.exe (#72)

  • Fixed: bundle create: OpenAPI specification parameter alignment (#153)

  • Fixed: calendar add: Fixed calendar add functionality (#204)

  • Fixed: calendar create: OpenAPI specification parameter alignment and help message (#94)

  • Fixed: calendar update: OpenAPI specification parameter alignment, help message and functionality (#200)

  • Fixed: property update: Removed input option and corrected parameters and functionality (#200)

  • Fixed: trigger assign-execution-user: Fixed function naming conflict causing command failure (#201)

  • Fixed: trigger unassign-execution-user: Fixed function naming conflict causing command failure (#201)

  • Fixed: universal-event publish: Now requires input option for complex JSON attributes (#202)

  • Fixed: universal-event push: Corrected parameters (#202)

  • Fixed: universal-template update-extension-archive: Added missing parameters (#106)

  • Fixed: universal-template import: Removed unrelated parameters (#101)

  • Fixed: universal-template update: OpenAPI specification parameter alignment (#187, #148)

  • Fixed: universal-template create: OpenAPI specification parameter alignment (#187, #148)

  • Fixed: user create: Made userPassword optional and added parameter mapping support (#203, #208)

  • Fixed: user create-token: Fixed command functionality (#206)

  • Fixed: webhook enable and webhook disable: Error response code 400 (#205)

  • Fixed: workflow update-edge, workflow update-vertex, workflow update-vertex: Corrected workflowid parameter mapping and removed read-only sysId property (#176)

  • Fixed: workflow add-vertex: Added missing parameter condition_expression (#102)

uac-cli-1.0.1 (2025/01/22)

Fixes

  • Fixed: Fix issue preventing uac-cli from running on AWS Linux 2023 (#64)

uac-cli-1.0.0 (2024/12/06)

Initial Release