System properties reference

Provides a detailed reference for system properties configurable from the UI settings page, including their descriptions, constraints, and property names.

Auditing

These properties configure the main settings for audit logging, such as log retention duration and user justifications.

Table 1. Auditing properties
Setting Description Constraints Property name
Retention days Define the maximum duration for which audit records are retained in the database before they are removed.
  • Required: true
  • Min: P30D (30 days)
  • Max: P730D (730 days)
 uno.audit.max.retention.duration
Enable justification Select to request a justification from users when they perform specific actions.
  • Required: false
 engine.justification.enabled

When justification is enabled, the following properties define which fields are required.

Table 2. Required justification fields
Setting Description Constraints Property name
Ticket number Select to require users to provide a ticket number when submitting a justification.
  • Required: false
 engine.justification.ticket-number.required
Description Select to require users to provide a description when submitting a justification.
  • Required: false
 engine.justification.description.required
Category Select to require users to provide a category when submitting a justification.
  • Required: false
 engine.justification.category.required
Justification categories Define the categories that users can select from when a justification category is required.
  • Required: true
 engine.justification.categories

Workload orchestration

Use these properties to configure process nesting levels, task timeouts, and email notification templates.

Table 3. Workload orchestration properties
Setting Description Constraints Property name
Maximum nesting level Define the maximum nesting level for sub-workflows in the plan. Workflow instances that exceed this level are suppressed.
  • Required: true
  • Min: 1
  • Max: 100
 uno.max.nesting.level
Human task cancellation period (seconds) Define the period in which a completed human task can be cancelled.
  • Required: true
  • Min: 0
  • Max: 60
 uno.human-task.cancel.timeout.seconds
Human task email creation template Define the HTML template for the email notification sent when a human task is created. The following variables are available for use in the template: ${QUEUE}, ${TASK_ID}, ${TASK_TITLE}, ${TASK_LINK}, ${ASSIGNEE}, ${OLD_ASSIGNEE}.
  • Required: true
 uno.human-task.mail.template.created
Human task email assignment template Define the HTML template for the email notification sent when a human task is assigned, reassigned, or unassigned. The following variables are available for use in the template: ${QUEUE}, ${TASK_ID}, ${TASK_TITLE}, ${TASK_LINK}, ${ASSIGNEE}, ${OLD_ASSIGNEE}.
  • Required: true
 uno.human-task.mail.template.assigned

Endpoint monitoring

These properties configure the frequency and constraints for monitoring endpoint availability.

Setting Description Constraints Property name
Endpoint monitor timer frequency

Defines how often the system scheduler checks for endpoints that require monitoring. This global setting determines the cycle for processing connectivity tests.

Note: This value should be greater than or equal to the Minimum endpoint monitor frequency.
  • Required: true
  • Min: PT10S (10 seconds)
  • Max: PT1H (1 hour)
 uno.endpoint.monitor.timer.frequency
Minimum endpoint monitor frequency

Defines the minimum permitted frequency that a user can set on an individual endpoint definition. This acts as a global guardrail to prevent users from configuring aggressive polling that could overload the system.

If a user attempts to define an endpoint with a frequency lower than this value, the system defaults to this global minimum.
  • Required: true
  • Min: PT10S (10 seconds)
  • Max: PT1H (1 hour)
 uno.endpoint.monitor.frequency.min

Planning

These properties define time windows for task planning, history retention durations, and cleanup frequencies.

Table 4. Planning properties
Setting Description Constraints Property name
Maximum non-active window (days) Define the maximum number of days into the future for which workflow instances are pre-generated and kept in the database ready for scheduling. This forward-looking window is automatically extended each day. The default value is 14 days.
  • Required: true
  • Min: P7D (7 days)
  • Max: P30D (30 days)
 uno.planning.not-active.window.max
Minimum non-active window (days) Define the minimum number of days for which workflow instances remain pre-generated in the database. When the forward-looking window drops to this threshold, the system automatically generates new instances to restore the maximum window.
  • Required: true
  • Min: P1D (1 day)
  • Max: P14D (14 days)
 uno.planning.not-active.window.min
Plan extension frequency (minutes) Define the frequency at which the plan is extended, which maintains the forward-looking pipeline of non-active workflow instances.
  • Required: true
  • Min: PT1M (1 minute)
  • Max: PT1H (1 hour)
 uno.planning.active-window.extension
Active window (hours) Define the time window in which dependencies are resolved and active workflow instances are launched.
  • Required: true
  • Min: PT1H (1 hour)
  • Max: P7D (7 days)
 uno.planning.active-window
Plan cleanup retention (days) Define the duration for which completed workflow instances are retained in the plan before they are removed.
  • Required: true
  • Min: P1D (1 day)
  • Max: P14D (14 days)
 uno.planning.cleanup.retention.duration
Task history retention (days) Define the duration for which task history runs are retained before they are removed.
  • Required: true
  • Min: P10D (10 days)
  • Max: P730D (730 days)
 uno.job.run.history.retention.duration
Failed tasks cleanup retention (days) Define the duration for which failed task instances are retained in the database before they are removed.
  • Required: true
  • Min: P14D (14 days)
  • Max: P90D (90 days)
 uno.planning.cleanup.failed-jobs.retention.duration
Failed tasks cleanup frequency (hours) Define the frequency at which the cleanup process runs to remove expired failed task instances from the database.
  • Required: true
  • Min: PT1H (1 hour)
  • Max: PT12H (12 hours)
 uno.planning.cleanup.failed-jobs.frequency

GenAI

Use these properties to set operational limits for AI agents, such as prompt context size and maximum actions.

Restriction: These properties are not available in HCL Universal Orchestrator SaaS environments.
Table 5. GenAI properties
Setting Description Constraints Property name
Maximum prompts in context Define the maximum number of previous user prompts to include in the context for each new request.
  • Required: true
  • Min: 10
  • Max: 100
 uno.genai.agent.max-user-prompt-for-context
Maximum conversation actions Define the maximum number of actions that can be performed in a single conversation.
  • Required: true
  • Min: 1
  • Max: 200
 uno.genai.agent.max-action
Maximum unattended actions Define the maximum number of actions that can be performed without user intervention.
  • Required: true
  • Min: 1
  • Max: 50
 uno.genai.agent.max-unattended
Internal agents model Specifies the model used for internal agents (currently used for workflow creation), as workflow creation now uses the same configuration as Basic AI Agents.
  • Required: false

uno.genai.agent.internal.model

Timings and expiration

These properties manage the expiration durations for personal, service, and cross dependencies API Keys, group caches, and dashboard metrics.

Table 6. Timings and expiration properties
Setting Description Constraints Property name
Personal API key expiration (days) Specify the number of days before personal API Keys expire.
  • Required: true
  • Min: P7D (7 days)
  • Max: P730D (730 days)
 uno.microservice.apikey.personal.expiration.duration
Service API key expiration (days) Specify the number of days before service API Keys expire.
  • Required: true
  • Min: P7D (7 days)
  • Max: P1825D (1825 days)
 uno.microservice.apikey.service.expiration.duration
Cross dependencies API key expiration (days) Specify the number of days before cross dependencies API Keys expire.
  • Required: true
  • Min: P7D (7 days)
  • Max: P1825D (1825 days)
 uno.microservice.apikey.crossdependencies.expiration.duration
Groups cache expiration (days) Specify the number of days before the group cache expires.
  • Required: true
  • Min: P1D (1 day)
  • Max: P365D (365 days)
 uno.groups.cache.expiration.duration
Dashboard metrics cleanup frequency (minutes) Specify the frequency at which the cleanup process runs to delete old dashboard timeseries metrics.
  • Required: false
  • Default: PT10M (10 minutes)
 uno.metrics.cleanup.frequency
Dashboard metrics retention (days) Set the number of days to keep metric data before it is automatically removed.
  • Required: true
  • Min: P1D (1 day)
  • Max: P30D (30 days)
 uno.metrics.expiry.duration.days

Tenant properties

These properties define tenant-specific details for identification, display names, and user domains.

Restriction: These properties are available only in multitenant deployments.
Table 7. Tenant properties
Setting Description Constraints Property name
Name Specify a unique name to be used as the hostname prefix.
Warning: If you modify the tenant name after agents (excluding cloud agents) have been installed, the agents become unlinked. The connection to the agentmanager fails (returning a 404 error in the logs) because the agent configuration is not automatically updated to reflect the new hostname prefix. To relink the agents to the correct environment, you must manually align their configurations (for example, by updating the agent.properties file for on-premises deployments or the deployment set for Kubernetes).
  • Required: true
 tenant.name
Display name Specify a display name for the tenant. This name is shown in the UI.
  • Required: true
 tenant.displayName
Tenant ID The unique system-generated identifier assigned to the tenant.
  • Read-only: true
 tenant.id
Marketplace ID The unique identifier associated with the marketplace subscription for the tenant.
  • Read-only: true
 tenant.marketplaceId
Gateway URL The specific network address used to access the gateway services for the tenant.
  • Read-only: true
 tenant.gatewayUrl
Agent manager URL The specific network address used to connect installed agents to the agent manager for the tenant.
  • Read-only: true
 tenant.agentManagerUrl
User domains Add authorized user domains for this tenant.
  • Required: false
 tenant.userDomains
Removal token The removal token is a unique string that is required to delete the tenant. It should be provided to the tenant administrator to delete the tenant.
  • Read-only: true
 tenant.removalToken