Setting configuration properties

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

Automation for Jira includes a number of configuration properties that let you check or change the default values related to various actions, conditions, and other items.

What permission do you need?

You need to be a Jira administrator to view or change the configuration properties.

Solution

Checking the current value

To check the property’s current value:

curl -u <user>:<password> http://<JIRA_BASE_URL>/rest/cb-automation/1/configuration/property/<PROPERTY_KEY>

Changing the value

To change the value:

curl -u <user>:<password> -X PUT -H 'Content-type: application/json' --data '{"key":"<PROPERTY_KEY>","value":"<VALUE>"}' http://<JIRA_BASE_URL>/rest/cb-automation/1/configuration/property/

For example:

curl -u admin:admin -X PUT -H 'Content-type: application/json' --data '{"key":"outgoing.webhook.timeout.ms","value":"50000"}' http://jira.atlassian.com:8080/jira/rest/cb-automation/1/configuration/property/

For Jira running on Windows server, you can use Invoke-webrequest. The script below was tested on Windows Server 2016:

$user = 'YOUR_USER_ADMIN'$pass = 'PASSWORD'$pair = "$($user):$($pass)"$encodedCreds = [System.Convert]::ToBase64String([System.Text.Encoding]::ASCII.GetBytes($pair))$basicAuthValue = "Basic $encodedCreds"$Headers = @{Authorization = $basicAuthValue}$Uri = 'http://YOURJIRABASEURL/rest/cb-automation/1/configuration/property/bulk'$Form = @{"ms.teams.notification.action.url.prefix"="https://"}Invoke-WebRequest -Uri $Uri -Method Put -Body ($Form|ConvertTo-Json) -ContentType "application/json" -Headers $Headers

List of properties

Here’s a list of properties that you might find useful. We’ll keep updating it.

Category	Property key	Data type	Default value	Description
Project Admin permissions	`permissions.project.admin.allow`	Boolean	true	Specifies whether project admins can manage automation rules.
Project Admin permissions	`permissions.project.admin.groups`	String	null	Lets you limit project admins who can manage automation rules to specific groups only. The value contains a CSV list of groups.
Service limits	`max.issues.per.search`	Long	1000	Limits the number of issues returned by the JQL search.
Service limits	`max.processing.time.per.day`	Long	3600	Specifies how long the same rule is allowed to run per day. The value is in seconds.
Service limits	`rule.rate.per.five.second`	Long	2	Specifies how many times the same rule can be executed during a 5-second time window.
Service limits	`max.rules.per.hour`	Long	5000	Specifies the maximum number of times the same rule can be executed per hour.
Service limits	`max.queued.items.per.rule`	Long	25000	Specifies the maximum number of executions that can be queued for the same rule.
Service limits	`max.queued.items`	Long	100000	Specifies the maximum number of items in the automation queue.
Service limits	`aggressive.timeout.threshold`	Long	30000	Specifies the maximum rule execution time. After this time, the rule is reported as causing timeouts. The value is in milliseconds.
Service limits	`short.scheduled.interval.issue.limit`	Long	1000	Limits the number of issues returned by the JQL search in the scheduled trigger.
Service limits	`branch.rule.immediate.priority.item.limit`	Long	10	Specifies the maximum number of branch executions with immediate priority.
Service limits	`audit.log.retention.period.days`	Long	90	Specifies how long audit log entries are kept for a rule. The value is in days.
Action and condition specific	`outgoing.webhook.timeout.ms`	Long	30000	HTTP timeout for outgoing webhooks. The value is in milliseconds.
Action and condition specific	`user.condition.get.users.limit`	Integer	50	Specifies the maximum number of users that can be retrieved from a single role in the User condition.

Updated on May 31, 2024

Was this helpful?

It wasn't accurate

It wasn't clear

It wasn't relevant

Atlassian Support