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

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.

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

Timings and expiration

These properties manage the expiration durations for personal and service API keys, as well as group caches.

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
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

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. Required: true tenant.name
Display name Specify a display name for the tenant. This name is shown in the UI. Required: true tenant.displayName
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